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Chapter 1 
Introduction 

NCR SCSI I/O Processor (53C700) 


I/O Performance 

The demands on today's I/O interfaces are being 
pushed by increased performance of personal 
computers and workstations. Extremely fast 
CPU's, both CISC and RISC only provide 
marginal system performance if their I/O 
interf^aces are not properly designed. Faster 
processors do not equal higher performance. 
Amdahl's Law describes this situation. 

"Assume I/O represents 10% of the system 
activity and its performance is kept constant. If 
CPU power is increased by a factor of 10:1, the 
net improvement is only 5:1, A 100:1 increase 
in CPU power is valueless if the net 
improvement in systems performance is only 
10:1." 

Interrupt service routines often take more than 
several hundred microseconds to execute and 
can be a large source of performance delays. 
Interrupts may be generated for exception 
conditions, I/O completion, saving/restoring 
buffer data pointers (for system check¬ 
point/restart), or low probability events 
available as options in todays SCSI 
definition. Interrupts can be reduced by 
using programmed I/O, however, this can be 
time consuming and requires much of the 
host computer cycle time. Therefore 
programmed I/O is not an adequate solution 
for multi-tasking operations. 

Another performance issue is the 
scatter/gather operation. With virtual storage 
so common today, many I/O's gather the data 
from several physical addresses in system 
memory. Latencies inherent in the reinstruct 
DMA operation can cause serious 
performance degradation by allowing the disk 
drive to slip a latency while the DMA is being 
re-instructed. 


I/O Flexibility 

Options in bus protocol allow increased I/O 
flexibility. Need for I/O flexibility is partially 
responsible for the popularity of the SCSI 
standard. I/O flexibility allows configuration 
of systems for a wide range of peripherals 
(from high performance cSsk dnves to hand 
held scanners). Additionally, VO flexibility 
supports command queueing, asynchronous 
or synchronous data transfers, caching 
controllers, peer to peer communication, etc.. 
Unfortunately, this implies firmware 
complexity. If these options are not carefully 
implemented, performance will suffer. 


A Better Solution 

First generation (NCR5380) SCSI devices 
are register oriented and require processor 
intervention to make the most fundamental 
protocol decisions. Users like the flexibility 
of these devices because the low-level 
firmware interface provides specific real time 
information about the SCSI bus and 
improved testability of the SCSI device. This 
generation of devices typically requires in 
excess of 4,000 lines of code to specify a 
SCSI-1 device implementation. 

Second generation (NCR53C90) SCSI 
devices provide on-chip state machines. 

Some complex SCSI sequences can be 
performed automatically which reduces 
protocol overhead. However, these devices 
have no decision making capability, because 
the internal sequences are fixed in hardware at 
VLSI design time. This generation of devices 
typically requires in excess of 2,500 lines of 
driver software to support this class of SCSI 
device. 
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Introduction 


The flexibility of the SCSI bus creates a 
dUermna for system integrators and OEM's 
alike. The dilemma is: should first and 
second generation SCSI devices be used as 
non-intelligent, stand-alone devices or should 
they be integrated into intelligent host adapter 
boards. Non-intelligent SCSI host ports or 
host bus adapters require a fair amount of 
processor intervention, but are inexpensive to 
implement Intelligent host adapters are more 
expensive than non-intelligent adapters. They 
provide slower decision niaking capabilities 
(less powerful CPU's), experience 
interpretation delays (2-8 msec required to 
start any I/O), and suffer from interprocessor 
communication delays. In systems not 
requiring a complex buffering scheme, non- 
intelligent host ^apters outperform their 
intelligent counterparts. For peripheral 
controllers, space is at a premium and 
complex peripheral interfaces require 
powerful microprocessors to transfer data at 
the high rates used by the peripheral interface. 
Therefore, SCSI chips requiring intense 
firmware can overwork the controller 
microprocessor making it unable to perform 
required tasks. Limited available space 
usually excludes adding an extra processor or 
replacing it with a more powerful one. 

With MIPS increasing in the system CPU, 
the delays caused by intelligent host adapter 
cards and slow peripheral controllers pose 
problems for the system integrator. TTie 
simplest solution is to build complex, 
versatile H/W sequences inside the SCSI 
components or to add additional CPU power 
in the SCSI device board. Both solutions are 
costly (space and component cost) and do not 
adequately address the problem. 


Third Generation Requirements 

To accommodate the flexibility requirements 
of the SCSI bus (reducing interrupts and 
controlling board cost), an additional level of 
intelligence and integration is required for 
next generation SCSI devices. Third 
generation SCSI devices must make 
execution decisions based on phase changes 
on the SCSI bus and compare specific 


incoming data values which will result in a 
minimum number of interrupts to the external 
processor. 

A programmable SCSI device that executes 
SCSI oriented commands is required. These 
new devices must reduce intermpt service 
routine complexities by providing unique 
status values to the external processor for 
any interrupts that do occur. Additionally, a 
foUy integrated DMA channel would allow 
full use of available host bus bandwidth. 

This is the key to overall VO performance 
given current use of virtual memory schemes 
which require the ability to support 
scatter/gather memory operations without 
processor intervention. 

Third generation SCSI devices require only a 
few hundred lines of driver code. This code 
is required for exception conditions and for 
passing addresses of the user data buffer to 
the device. Error recovery occurs at the high 
level interface. In second generation chips, 
the firmware is required to manage every 
detail of the error recovery mechanism, 
because the high level interface is fixed and 
has only one entry point. Programmable 
SCSI chips allow error recovery using the 
high level interface, because the algorithm can 
be entered at any command and error specific 
SCSI SCRIPTS™ can be developed. 


The NCR SCSI I/O Processor 
(SlOP) 

The NCR 53C7(X) is the first intelligent SCSI 
host adapter on a chip. A high-performance 
re-usable SCSI core and an intelligent 32-bit 
bus master DMA have been integrated with a 
SCSI SCRIPTS processor to accommodate 
the flexibility requirements of SCSI-1, SCSI- 
2, and eventually SCSI-3. This flexibility is 
supported while solving the protocol 
performance problems that have plagued both 
intelligent and non-intelligent adapter designs. 


NCR 53C700 Programmer's Guide 


1-2 


2/23/90 




Introduction 


SCSI Component 

In addition to the reliability components of 
NCR's other SCSI chips: 

• lOK volts ESD protection 

• >350 mV Bus Hystersis 

• Immunity to bus reflections due to 
impedance mismatches 

• Controlled bus assertion times which 
reduces generated RFI, improves 
reliability, and increases the chances 
for FCC approval 

• Latch-up protection >100 mA 

• Voltage feed-thru protection 

The SCSI core in the 53C700 is reusable and 
desired to migrate to SCSI-2 wide and fast 
requirements. It offers synchronous transfers 
up to 6.25 MBytes/sec with asynchronous 
transfers greater than 5 MBytes/sec. 
Synchronous offsets up to 8 are supported. 

The SCSI core offers low-level register 
access as well as the high-level control 
interface. Like first generation SCSI devices, 
the 53C700 SCSI core can be accessed as a 
register oriented chip. The ability to sample 
and assert any signd on the SCSI bus can 
used for manufacturing test and diagnostic 
procedures. Loopback diagnostics are 
supported, the SCSI core may perform self¬ 
selection and operate as both an initiator and a 
target to verify that internal data paths are 
operational. The 53C7(X) can test the SCSI 
pins for physical connection to the board or 
the SCSI bus. 

Unlike previous generation devices, the 
53C700 SCSI core is controlled by the 
integrated DMA through a high-level logical 
int^ace. High level programming language 
commands controlling the SCSI core may be 
chained from main host memory. These 
commands instruct the SCSI core to select, 
reselect, disconnect, wait for a disconnect, 


transfer user data, transfer SCSI information, 
change bus phases, and implement all aspects 
of the SCSI protocol. 

Also, the SCSI SCRIPTS processor will 
transfer execution control (jump, call, return, 
and interrupt) based on SCSI bus phase 
comparisons. A value in the SCSI SCRIPTS 
command can be compared to the actual data 
value on the SCSI bus, allowing the same 
transfer of control based on input data 
compares. The SCSI SCRIPTS processor is 
a special 2 MIPS processor located on the 
SCSI chip. 


DMA COMPONENT 

The DMA component is a bus master DMA 
chip that attaches easily to the 80486, 80386, 
80286, 80386SX, and 80376 processors. It 
is designed for 25 Mhz 80386 bus timings 
and may be externally adapted to ISA (AT), 
EISA, Micro Channel™ , etc.. 

The 53C700 supports 16 or 32-bit memory 
and automatically supports misaligned DMA 
transfers. As with the 80386, data bus 
enables are provided for each byte lane. An 
on-chip, 32 byte FIFO allows 2,4, or 8 long 
words to be burst across the memory bus 
interface, providing memory transfer rates in 
excess of 50 MBytes/sec. 

The DMA is tightly coupled to the SCSI core 
through the SCSI SCRffTS processor which 
supports uninteiTupted scatter/gather memory 
operations with only a 500 nanosecond delay 
between memory segment transfers. 

A Watchdog Timer provides a "bus safety" 
feature. The flexible arbitration scheme 
allows daisy chained or "ored" memory bus 
request implementations. 
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SCSI SCRIPTS™ Processor 

The SCSI SCRIPTS processor is a specially 
designed 2 MIPS processor that allows both 
DMA and SCSI instructions to be fetched 
from host memory. Algorithms written in the 
SCSI SCRIPTS language and then compiled 
control the SCSI and DMA cores and are 
executed from 16 or 32-bit system memory. 
Complex SCSI bus sequences are executed 
independendy of the host CPU. 

The SCSI SCRIPTS processor can begin a 
SCSI I/O operation in 500 nsec. This 
compares to the 2-8 msec required for 
traditional intelligent adapters. The SCSI 
SCRIPTS processor offers performance and 
customization. By designing your own 
algorithms, you can tune SCSI bus 
performance adjusting it to new bus device 
types (i.e. scanners, communication 
gateways, etc.) or changes in the SCSI 
logical bus definitions, or quickly incorporate 
new or popular options. 

The SCSI SCRIPTS processor is how the 
53C700, the NCR third generation SCSI chip 
implements flexibility without sacrificing I/O 
performance. 


NCR SCSI SCRIPTS™ 

Description 

SCSI SCRIPTS are independent of the CPU 
and system bus. SCRIPTS for an EISA 
implementation of a 80386 can therefore be 
identical to the scripts for a 80386SX Micro 
Channel™ implementation. 

After power up and initialization of the 
53C700, the chip may be operated in one of 
two modes: 

1) Low level register interface 

2) SCSI SCRIPTS chained mode. 

In the low level register interface, you have 
access to the DMA control logic and the SCSI 
bus control logic and can operate the chip like 
an NCR 53C80. Access by an external 


processor to the SCSI bus signals and the 
low level DMA signals, allows use of a 
complicated board level test algorithm. The 
interface provides backwards compatibility 
with SCSI chips requiring unique timings or 
bus sequences to operate properly. Another 
low level feature is loop back testing. In loop 
back mode, SCSI core can be directed to talk 
to the DMA core, this allows the internal data 
paths to be tested all the way to the chip's 
pad. 

Operating in the SCSI SCRIPTS chained 
mode, the 53C700 requires only a SCSI 
SCRIPTS start address. All subsequent 
commands are fetched from external memory. 
Four bytes (or optionally two) at a time are 
fetched across the iAPX 286/386 DMA 
interface and loaded into the command 
register. Command fetch and decode time is 
minimal at about 500 nanoseconds. 
Commands are fetched until an interrupt 
command is encountered or until an external, 
unexpected event (e.g. hardware error 
detected) causes an interrapt to the external 
processor. The full set of SCSI features in 
the command set allow re-entry of the SCSI 
algorithm at any point. A high level interface 
is required for both normal and exception 
conditions. Therefore switching to a low 
level mode for error recovery as is the case 
with today's second generation SCSI VLSI is 
never necessary. 
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Chapter 2 

SCSI SCRIPTS ™ Machine Language Description 


This chapter describes each SCSI SCRIPT™ 
command at the programmer, detailed, bit 
level. Normally you will use the SCSI 
SCRIPTS compiler described in following 
sections, but for debugging purposes, each 
command is described in detail. Each 
command description consists of a bit diagram 
of the command, a brief overview of the 
command and a description of each field 
within the command. 


Bits 31-30 are SCSI I/O Processor opcodes. 

00 equals Block Move Command 
01 equals I/O Command 

10 equals Transfer Control Command 

11 equals NCR Reserved 


BLOCK MOVE COMMAND (00) 


DCMD Register 


DBC Register 



Second 32-bit word of the Block Move Instructions 


Figure 1. Block Move Instructions 


Overview 

The Block Move command transfers data 
to(from) user memory from(to) the SCSI bus. 
No distinction is made between user data and 
SCSI information, such as command or 
message bytes. 


A series of SCSI SCRIPTS is written to move 
all types of data, with no requirement for 
separate firmware to distinguish between user 
and SCSI data. 
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SCSI SCRIPTS ™ Machine Language Description 


Note that the data may come fix)m any 
memory address, so scatter/gather operations 
for user data are transparent to the chip and the 
external processor. Write a separate Block 
Move for each piece of data to be moved. 

Use the 32 byte DMA data buffer to speed 
data transfers between user memory and the 
I/O Processor, Synchronous SCSI data in 
transfers can use the 8 byte FIFO. 

Note: The possible values for each field are 
given in binary. 


Block Move Command 
First SCRIPTS Word 


Block Move opcode - 00 

Bits 31-30 

Indirect data address flag (I) Bit 29 

0 SCSI or user data is moved to(from) the 
32-bit data start address for the block 
move. The value is loaded into the chip's 
address register and incremented as data is 
transferred. 

1 The 32-bit SCSI or user data start 

address for the Block Move is the address 
of a pointer to the actual data buffer 
address. The value at the 32-bit data start 
address is loaded into the chip's DNAD 
register via a second long word (four byte 
transfer across the host computer bus). 

This option implies three DMA long word 
transfers, rather than two transfers. Once 
the data buffer address is loaded, it is 
executed as if the chip operates in the 
direct mode. This indirect feature allows 
specification of a table of data buffer 
addresses. Using the NCR SCSI 
SCRIPTS compiler, the table offset is 
placed in the script at compile time. Then 
at the actual data transfer time, the offsets 
are added to the base address of the data 
address table by the external processor. 
This allows the logical I/O driver to build a 
stracture of addresses for an I/O rather 
than treating each address individually. 


Also, this feature makes it possible to 
locate SCSI SCRIPTS in a PROM. 


Block Move Opcodes Bit 28-27 

The SCSI role (target or initiator) causes the 
chip to react diferently, with respect to the 
phase line values. A primary difference 
between roles is whether the SCSI phase 
lines are sensed or driven. There are also 
major differences between the two roles in the 
command phase. Therefore, the Block Move 
functions are described for each SCSI role - 
target and initiator. 

Target Role Function—00 

The target role allows DMA user or SCSI data 
First the chip determines whether the previous 
command has completed, or a reselect has 
occurred. The SCSI phase bits are asserted to 
tile value requested by the Block Move 
command. If the command phase has been 
requested, the chip will: 

• Wait for the first byte received. 

• Decode the byte to determine the 
number of SCSI command bytes to 
receive. 

• Write the command length into the 
DBC register. 

An invalid group code value causes the 
chip to use the original value in the 
DBC register. A zero value stops 
processing, creates an interrupt with 
the first byte, and stops transferring 
command bytes. 

• Transfer the correct number of bytes 
into the address designated by the 
Block Move command. 

If any phase (other than command) is 
requested, the chip transfers the number of 
bytes requested to(from) the address 
requested. 
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SCSI SCRIPTS ™ Machine Language Description 


Should the initiator turn on attention at any 
time during the transfer, the transfer will he 
completed, and then an interrupt will occur. 

Target Role Function—01.10. or 11 

These are illegal values and will generate an 
invalid command interrapt if the chip is in the 
target role. 

Initiator Role Function-00 
Reserved 

Initiator Role Function-01 

In the initiator role, this operation waits for a 
valid phase and DMA data. After verification 
that the previous command is complete or a 
reselect has occurred, and the chip waits for a 
previously unserviced phase before executing 
the Block Move command. You can program 
the 53C700 to pause until the SCSI device it is 
communicating with goes to the next phase. 

A comparison is made between the expected 
phase bits in the SCSI SCRIPTS and the 
latched phase value. If the two values are not 
equal, the chip issues a phase mismatch 
intermpt and halts execution. This wait 
capability is normally used to allow the target 
to pace the chip in the initiator role. When a 
phase change is expected, the wait 
synchronizes the expected phase with the 
Block Move for that phase. 

Initiator Role Function-10. or 11 

These are illegal values and will generate an 
invalid command interrupt if the chip is in the 
initiator role. 


SCSI Phase Lines Bit 26-24 

These three SCSI phase lines perform 
comparisons to the actual SCSI bus phase 
lines. The SCSI bus phase value is latched 
when REQ goes active. The value is stored in 
SSTAT2 (bit 2 through bit 0 -- MSG, C/D, & 
I/O). Before any data is moved, the chip 
compares the expected value with the actual 
value (or waits for a new phase and compare). 


24-Bit Byte Count, Bit 23-00 

This count value specifies the exact number of 
data bytes to be moved between the SCSI bus 
and system memory. As the SCSI SCRIPTS 
command is decoded, the value is moved into 
the DBC register. When the user specified 
burst size of data is available in the DMA 
FIFO, the SCSI I/O Processor will: 

• Gain access to the system bus. 

• Transfer the burst size. 

• Decrement the byte counter (byte 
count). 

• Increment the next address register 
(data address). 

The process will continue until the byte count 
is zero. At that time, the next SCSI SCRIPTS 
command will be fetched. 


Block Move 

Second SCRIPTS Word 

Data Start Address for the Block 
Move Bits 31-00 

This value specifies the address of data in 
memory (direct mode) or the address of the 
actual adii*ess (indirect mode). The DNAD 
register is updated with the address of the 
actual data and is incremented with each chip 
DMA transfer. 

The Block Move command is very powerful 
for several reasons. 

1) No distinction is made between user 
data and SCSI command, message, or 
status data. 

2) Data can be stored in any area of 
system memory with little performance 
impact (one command fetch). 

3) The indirect feature allows a table of 
addresses instead of requiring the 
address to be in the command. 
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4) A scatter/gather operation has little 
performance impact, because the only 
overhead is 500 nanoseconds (direct 
mode) or 750 nanoseconds (indirect 
mode). So, one Block Move 
command for each segment of data in 
memory is economic^ with the SCSI 
I/O processor architecture. 

In the initiator role, the Block Move wait 
feature is useful for high performance SCSI 
SCRIPTS that do not compare for any 
unexpected phases before executing a Block 
Move command. If the phase does not match, 
then an external interrupt is generated. 

For the high performance SCSI SCRIPTS 
algorithm, exceptions are abnormal and are 
handled by the external processor. Normally, 
the Conditional Transfer command (see I/O 
Command) compares actual to expected 
phase. The first Conditional Transfer 
command must have the "wait" option on (to 
synchronize the commands with tiie actual bus 
phase) and each subsequent command should 
have Ae "wait" option turned off. 
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I/O Command 


DCMD Register 


DBC Register 



Second 32-bit word of the I/O Instructions 


Figure 2. VO Instructions 


Overview 

The I/O command performs select and reselect 
SCSI operations. Each function defined is a 
direct command to the SCSI portion of the 
530700. The functions vary if the chip is in 
the target or initiator role, so the functions are 
described separately for each role. 


I/O Command 
First SCRIPTS Word 


SCSI I/O Processor opcode » 01 
Bits 31-30 


VO Command Opcodes Bits 29-27 

Five functions are defined for target and 
initiator role, three are reserved for future 
expansion. Using the reserved function codes 
generates an illegal command intermpt 
stopping execution. 


NCR 53C700 Programmer's Guide 


2-5 


2/23/90 







SCSI SCRIPTS ™ Machine Language Description 


Target Role — function 000 
Perform reselection ~ The chip arbitrates for 
the SCSI bus and then performs a reselection. 
Arbitration continues until the chip is 
successful, unless there is a bus initiated 
interrupt (e.g. selection). If arbitration 
terminates b^ause of a bus initiated interrupt 
(selection or reselection) the chip will use the 
32”bit jump address value to fetch the next 
instmction and begin execution at that 
address. If the command is successful, then 
the next sequential instraction is fetched and 
executed. Note that the targetAnitiator role 
automatically change to reflect what is actually 
happening on the bus. 

After completion of the bus initiated interrupt 
processing (sequence goes to bus free), the 
chip reverts to the role set by the user in the 
registers. Some caution is required here. If 
the chip is set to an initiator role, gets selected, 
changes to the target role automatically, 
disconnects, does some processing, and then 
issues a reselect command (without being set 
to the target role by the external processor), a 
selection will occur. Because the chip was in 
the initiator role (at the time of selection), it 
reverts to that foie after the disconnect and bus 
free. 

Target Role — function 001 

Perform disconnect — The chip physically 

disconnects from the SCSI bus. 

Target Role — function 010 

Wait for select -- The chip waits for a SCSI 

selection by another device on the SCSI bus. 

If the chip is already selected, then the next 
SCSI SCRIPTS is fetched and executed. 
When a bus iiutiated interrupt or reselect 
occurs, the chip changes to the initiator role 
and fetches the next command from the 
address pointed to by the 32-bit jump 
address, and continues execution. 

Target Role — function 011 
Assert bit ~ The chip asserts the latches in the 
SCSI output data register, but nothing is 
driven onto the SCSI bus. Consequently, this 
function should not be used in the target role. 


Target Role — function 100 
Reset bit — The chip resets the latches in the 
SCSI output data register, but nothing is reset 
on the SCSI bus. Consequently, this function 
should not be used in the target role. 

Target Role — function 101. 110. Ill 
These are not currently defined and will cause 
an illegal command interrupt if used. 

Initiator Role — 000 

Perform selection — The chip arbitrates for the 
SCSI bus and then performs a selection. 
Arbitration continues until the chip is 
successful or a bus initiated interrupt (e.g. 
reselection) occurs. If arbitration terminates 
because of a bus initiated interrupt (as a result 
of a select or reselect), the chip uses the 32-bit 
jump address to fetch the next instruction and 
begin execution at that address. The 
targetfinitiator role automatically changes to 
reflect bus actions. 

After completion of the bus initiated interrupt 
processing (sequence goes to bus free), the 
chip reverts to the role set by the user. If the 
selection is successful, the next instruction is 
fetched and executed. If bit 24 (the attention 
flag) is set, then the chip performs a select 
with attention. 

Note: 

Because the chip automatically changes roles 
and jumps to an alternate address if the select 
or reselect fails, a bus initiated interrupt can be 
processed by the chip with no external 
intervention. The alternate jump address 
should contain the address of an algorithm for 
a selection or reselection. Include in the 
address a wait for selection (target role) 
command. That command's alternate address 
is the reselection algorithm (initiator role). 
The 53C700 can c^termine exactly what 
happened and transfer control to the 
appropriate SCSI SCRIPTS algorithm. 
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SCSI SCRIPTS ™ Machine Language Description 


Initiator Role — QQl 

Wait for disconnect ~ The initiator waits for a 
disconnect fix)m the SCSI bus. A legal 
disconnect is defined as a loss of busy and 
select for the specified bus free time following 
a DISCONNECT message or a COMMAND 
COMPLETE message. & the disconnect is 
legal, the next SCSI SCRIPTS command will 
be executed, otherwise an unexpected 
disconnect interrupt will be generated. 

Initiator Role - 010 

Wait for reselection ~ The initiator waits for a 
reselection from a previously selected SCSI 
device. If the operation completes as 
expected, then the next instruction is fetched 
and executed by the 53C700. However, if the 
chip is selected, then the dtemate jump 
address should contain the address of an 
algorithm for a selection. Include in the 
ac&ess a wait for selection (target role) 
command. That command's alternate address 
is the error recovery algorithm (for initiator 
rolereselect). The chip can determine 
exactiy what happened and transfer control to 
the appropriate SCSI SCRIPTS algorithm. 

Note: 

With the 53C700 byte compare capability of 
the transfer control command, the SCSI 
SCRIPTS algorithm can determine which 
target reselected the initiator and can jump to 
the correct algorithm for that particular target. 
SCSI SCRIPTS can be tuned for the various 
types of targets available and executed with no 
external processor intervention. 


Initiator Role - function 011 
Assert bit — The chip asserts the SCSI bus 
bits requested in the flags field. Currently 
three bits are defined, allowing the SCSI ACK 
target role and ATN bits to be set. Bit 10 is 
for target, bit 6 is for Acknowledge, and bit 3 
is for Attention. 

Initiator Role — function 100 
Reset bit ~ The chip resets the SCSI bus bits 
requested in the flags field. Currently two bits 
are defined, allowing the SCSI ACK target 
role and ATN bits to be reset. Bit 10 is for 
target, bit 6 is for Aclaiowledge and bit 3 is 
for Attention. 


Initiator Role — function 101. 110.111 
These are not currently defined and will cause 
an illegal command intermpt if used. 


SELECT WITH ATN - Bits 26-24 

If bit 24 is set, then the initiator SELECT 
command will cause the SCSI attention line to 
be set during the SELECT operation. 
Attention on is valid only during the initiator 
function 000. The bit is invalid for all other 
functions and will cause an intermpt. 

SCSI LD. 7-0 - Bits 23-16 

This eight bit field is the LD. for the SCSI 
chip to be selected in the initiator role and 
reselected in the target role. Set only one bit 
for either of the functions requested. These 
bits are not used for any function other than 
select or reselect. 

Flags Field - Bits 15-00 

These bits are used during the set or clear 
command. Bit 10, on places the chip in the 
targetAnitiator role. Bit 6, on sets/resets the 
SCSI acknowledge. Bit 3, on sets/resets the 
SCSI attention. Use the clear ACK command 
after the last target message-in byte has been 
verified for each separate message data Block 
Move command. The initiator has the 
opportunity to set attention before 
acknowledging the last message byte of a 
Block Move command. On each byte, if a 
parity error was detected on the message in 
operation, the ASSERT SCSI ATN is issued 
before the clear acknowledge is issued to 
accept the message. Use set Acknowledge to 
handshake bytes across the SCSI bus. Clear 
attention should be issued after the target has 
serviced the request for a message out by the 
initiator. 
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SCSI SCRIPTS ™ Machine Language Description 


I/O Command 
Second SCRIPTS Word 

Jump Address • Bit 31-00 

If the select, wait reselect, or reselect 
command fails, this thirty-two bit field 
specifies from which memory address to 
fetch the next SCSI SCRIPTS for execution. 
Normally, the next instruction is fetched in 
sequence if the requested operation completes 
witii no bus initiated inteirupt. 
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SCSI SCRIPTS ™ Machine Language Description 


Transfer Control Command 


DCMD Register 


DBC Register 



Second 32-bit word of the Transfer Control Command 


Figure 3. Transfer Control Command 


Overview 

The Transfer Control Command contains the 
JUMP, CALL, RETURN, and INTERRUPT 
operation codes. Each opcode is conditionally 
performed based on compares of SCSI phase 
values and incoming SCIS data values. The 
Transfer control command allows comparisons 
of current phase values on the SCSI bus or the 
first byte of data on any incoming bytes and 
transfers control to another address depending 
on the results of the test. 


These commands allow SCSI algorithms to be 
written in SCSI SCRIPTS and give the 
53C700 characteristics of a general purpose 
SCSI processor. With transfer control 
commands, you can program the chip, rather 
than simply buffering commands to be serially 
executed with no real-time decision making 
capabilities. 
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SCSI SCRIPTS ™ Machine Language Description 


Transfer Control Command 
First SCRIPTS Word 


SCSI I/O Processor opcode -10 
Bits 31-30 

Transfer Opcodes - Bits 29-27 

Four opcodes are currently defined that allow a 
transfer of control in the SCSI SCRIPTS 
language. All undefined opcodes cause an 
interrupt of illegal command. 


JUMP Command — 000 
If the condition evaluates according to the 
sequence control bits so the jump must be 
taken, the next instruction is fetched from 
memory at the 32-bit jump address. 

Otherwise, the next sequential address will be 
used as the instmction fetch address. 

CALL Command - 001 
If the condition evaluates according to the 
sequence control bits so the call must be taken, 
the next instruction is fetched from memory at 
the 32-bit call address. Otherwise, the next 
sequential address will be used as the 
instmction fetch address. 

The address of the next sequential command is 
stored in the chip's TEMP register in 
anticipation of a subsequent return address. If 
two CALL instmctions are executed without 
any intervening RETURN instmction, then the 
first return adtfress in the chip's TEMP register 
is overwritten by the second CALL. 

RETURN Command — OIQ 
If the condition evaluates according to the 
sequence control bits so the return must be 
taken, the next instmction will be fetched from 
memory at the 32-bit address contained in the 
TEh^ register, where it was stored by the 
previous call instmction. Otherwise, the next 
sequential address will be used as the 
instmction fetch address. The contents of the 
TEMP register may be undefined if a call 
instmction was not previously executed. 


INTERRUCT Command - 011 
If the condition evaluates according to the 
sequence control bits so the software intermpt 
must be taken, the chip halts execution and 
issues an intermpt request to the external 
processor. Otherwise, the next sequential 
address will be used as the instmction fetch 
address. 

The 32-bit jump address in the instmction is 
available in the chip's command register at the 
time of the intermpt. You can post a four 
byte, user unique error status to be used by the 
external processor's intermpt service routine. 
Thus, the cause of the intermpt can be easily 
decoded by firmware which reduces firmware 
intermpt service routine overhead. 


SCSI Phase Bits - Bits 26-24 

In the SCSI initiator role, these bits compare 
the actual SCSI lines (MSG, C/D, and I/O), if 
the phase compare bit is set in the sequence 
control field. Actual SCSI lines are a copy of 
the last valid SCSI phase line values. These 
bits are set in the SCSI SCRIPTS command to 
compare with the current SCSI bus phase 
lines, then branch to the SCSI SCRIPT™ that 
processes the particular phase that is currently 
active. Bit 26 is SCSI MSG, bit 25 is SCSI 
C/D, and bit 24 is SCSI VO. In the target role, 
these bits are ignored. 


Bits 23-20 

These bits are reserved for future use and must 
be zero. 
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SCSI SCRIPTS ™ Machine Language Description 


Sequence Control Bits - Bits 19-16 

SCSI SCRIPTS can use the current conditions 
on the SCSI bus to determine where to transfer 
control and execute alternative algorithms 
using the sequence control bits. The bits are 
defined as follows: 

• Bit 19 - Transfer if True/False. 

If the bit is set to 1, a transfer of control 
occurs if the phase or data values in the 
instruction are equal to the actual phase 
value on the SCSI bus or the first byte of 
the most recent asynchronous in phase. 

The byte could be a message in, data in, or 
status for the initiator and message out, 
command, or data out for the target role. 
When the bit is set to zero, the transfer 
control will occur if the comparison yields 
a false. 

• Bit 18 -- Compare the data byte value 
(bit 7 - bit 0 in the instruction) to the 
first byte of the most recent data, 
message, command, or status byte 
received. 

The user's SCSI SCRIPTS program can 
determine what routine to execute next, 
based on actual data values received across 
the SCSI bus. For example, the chip can 
compare for specific message values and 
process an extended message in SCSI 
SCRIPTS, with no external interrupt to 
the external processor. 

• Bit 17 “ In the initiator role, compare 
the SCSI phase line value (bit 26 - bit 
24) to the recent valid SCSI phase line 
values saved in the chip. 

Using this feature, the chip can react to 
actud bus conditions and determine which 
routines to execute next based on SCSI 
bus phase line values. Unexpected phase 
values can be compared for and error 
conditions or low probability events can 
be processed by SCSI SCRIPTS inside 
the chip. 


In the Target role, bit 17 on causes the 
chip to test for the attention line on. If the 
initiator has set attention, the chip (in the 
target role) can jump to a message out 
routine to determine what the initiator 
needs. This is normally placed after each 
SCSI phase to allow the initiator to turn on 
attention if an error is detected during the 
transfer, 

• Bit 16 - In the initiator role, wait for a 
previously unserviced phase change. 

You can program the chip to pause until 
the SCSI device it is communicating with 
has proceeded to the next phase. One 
normally uses this wait capability to pace 
the chip in the initiator role. When a phase 
change is expected, the wait is used to 
synchronize the expected phase with the 
actual phase detected on the SCSI bus. If 
both data and phase compare bits are set, 
the compare must be both true or both 
false for the transfer to occur. 

Mask Bits - Bits 15-8 

The mask bits allow selective comparison of 
bits within the data byte using SCRIPTS. 
During the compare, any bits that are on will 
cause the corresponding bit in the data byte to 
be ignored for the comparison. A user can 
code a binary sort to quickly determine the 
value of a byte. 

For instance, a mask of '7F' and data compare 
of '80' allows the SCRIPTS processor to 
determine whether or not the high order bit is 
on. 

Data Byte - Bits 7-0 

Compare this data byte value to the first byte 
of the most recent asynchronous data, 
message, command, or status byte received. 
The user's SCSI SCRIPTS program can 
determine what routine to execute next based 
on actual data values received. Using a series 
of these compares, the algorithm can process 
complex sequences with no intervention 
required by the external processor. 
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SCSI SCRIPTS ™ Machine Language Description 


Transfer Control Command 
Second SCRIPTS Word 

Data Jump Address - Bit 31-00 

This value specifies the address of the next 
instruction in memory to transfer control. The 
value is ignored both return and interrupt 
commands. However, the address is loaded 
into the chip's command register and is 
available to be read by firmware in the case of 
an interrupt command. 

If both data compare and phase compare bits 
are set, then both comparisons must be true or 
both must be false before the requested 
transfer will occur. There is no way to test 
one for false and the other for true. 

If neither the phase or data bit are set, and if 
the true/false bit is 1, the operation is executed 
unconditionally. 

If neither the phase nor the data bit is set and 
the true/false bit is 0, then the command has no 
operation assignment and can be used as a 
delay function, or to reserve SCSI SCRIPTS 
patch area. 
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Chapter 3 

Developing NCR SCSI SCRIPTS™ 


NCR Microelectronics has a 53C700 Software 
Development kit which supports the 
development of SCSI SCRIPTS. This kit 
includes: 

• Sample SCRIPTS 

• SCRIPTS Utilities 

• Tesi/Diagnostic SCRIPTS 

• A SCRIPTS compiler 

• Hardware Test Support 

Your local NCR Sales Office or Factory 
Representative will assist you with ordering 
information and current board level options. 

To develop an executable SCSI SCRIPT, first 
define the SCSI functions required. Identify 
what functions will be executed in SCRIPTS 
and what functions must be contained in 
system firmware. Then design the specific 
algorithms for the functions tiiat will be 
executed in the SCSI SCRIPTS portion of the 
SCSI logical I/O driver. 

Use the SCRIPTS compiler to code the 
algorithms SCRIPTS. Then compile to create 
the object code required as input by the 
53C700. The compiler output is like an object 
module, it includes relocation information 
required to load the SCRIPTS object module 
into main memory. 


At load time, the SCRIPTS jump addresses 
must be resolved using one of the utilities 
furnished in the software package. At start I/O 
time, another utility is used to patch in the 
correct buffer addresses, byte counts, 
destination I.D., etc. 

Writing a logical I/O driver is an easy task for 
the 53C700. This is illustrated in the first 
SCSI SCRIPTS example. This code will 
perform a read or write function using the 
53C700 in the high level chained mode. 
Because SCSI algorithms are so simple when 
written in SCSI SCRIPTS, you can rapidly 
prototype SCSI algorithms for a proof of 
concept and concentrate on more complicated, 
realistic algorithms. 

A SCSI SCRIPTS is comprised of two parts or 
areas: 

1) Definition area 

2) SCRIPT area 

In this example, the definition area is 
comprised of variable and absolute values. 
These values may describe a variable memory 
address location, variable byte count or a fixed 
status byte value. 


* The following are variable data values provided * 
i* external to the compiler and resolved at run-time * 


; Definition area INITIATOR ROLE 

; Target Device I.D. to be fixed at Start VO time. 

EXTERNAL device 

; Ten byte buffer for sending messages 

EXTERNAL sendmsg 

; Ten byte buffer for receiving messages 

EXTERNAL rcvmsg 
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Developing NCR SCSI SCRIPTS™ 


; Number of message bytes to send after selection 
EXTERNAL idcount 

; Number of command bytes 

EXTERNAL cmd_count 

; Buffer for the SCSI command 

EXTERNAL cmd_adr 

; Number of user data bytes 
EXTERNAL data_count 

; Address of user data buffer 

EXTERNAL data_adr 

; Error -- not message out after selection 


* Absolute values are stored in DNAD Register * 

* for purposes of interrupt processing * 


;* Note that 0X0 precedes the interrupt status * 
;* values and designates a hex value * 


ABSOLUTE erri = OxOffOl 

; Error ~ unexpected SCSI phase before command phase 
ABSOLUTE err2 = 0x0ff02 

; Error -- unexpected SCSI phase after a command transfer 
ABSOLUTE err3 = OxOffOS 

; Error ~ expected status phase 
ABSOLUTE err4 = 0x0ff04 

; No Error ~ good I/O 
ABSOLUTE ok = OxOffOO 

; Error ~ expected message outphase 
ABSOLUTE errS = 0x0ff05 

; Error -- expected message command complete 
ABSOLUTE err6 = 0x0ff06 
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Developing NCR SCSI SCRIPTS™ 


Single-Tasking SCSI Example 

The following is a simple SCSI SCRIPT that 
performs a single-tasking SCSI operation 
without disconnecting. 


If an unpredictable event occurs on the SCSI 
bus, a unique interrupt status value is DNAD 
stored in the 53C700's register and is 
available for interrupt processing. 


; select the device with attention on 
select am device resel_adr 

; if the next phase is not message out, interrupt 
int errl when not MSG_OUT 

; sent the i.d, message out to the target 
move idcount sendrnsg when MSG_OlJT 

; if the next phase is not command, interrupt 
int err2 when not CMD 

; send the command bytes 

move cmd_count cmd_adr when CMD 

; go to process cleanup if status phase 
jump end when STATUS 

; process data in phase 
jump input_data if DATA-IN 

; or data out phase 

jump output_data if DATA_OUT 

; unexpected phase if here 
interrS 

; process the data in phase 
input_data: 

move data_count data_adr when DATA_IN 

; and go process status 
jump end 

; process the data out phase 
output_data: 

move data_count data_adr when DATA_OUT 

; interrupt if not status phase 
end: 

int err4 when not STATUS 
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Developing NCR SCSI SCRIPTS™ 


; move the status byte into memory 
move 1 status_adr when STATUS 

; intermpt if message in is not next 
int errS when not MSG_IN 

; move the command complete byte in 
move 1 rcvmsg when MSG_IN 

; interrupt if it is not a command complete message 
int err6 if not 00 

; accept the message if there are no problems 
clear ack 

; wait for a physical disconnect 
wait disconnect 

; interrupt with an I/O complete 
int ok 
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Chapter 4 

NCR SCSI SCRIPTS ™ Utilities 


The development package includes these 
utilities and the SCSI SCRIPTS Compiler. 

InitSIOPO 

Declaration: 

void lnitSIOP( struct SlOP * ) 

InitSIOPO accepts a pointer to an SIOP struct 
or NULL. If NULL Aen all the members in 

_SCSIREGS_are assigned a value of 0. 

Otherwise copy the value from each member 

of the passed struct into_SCSIREGS_and 

put those into the chip. 

NOTE: 

This function will, by default, assign one 
struct to another. This is ANSI compatible, 
but older compilers may not support it. 
Therefore by defined KR to 1 each member 
will be assigned in turn. 

SetPhaseMMIntO 

Declaration: 

void SetPhaseMMint( BOOL) 

SetPhaseMMIntO turns the phase mismatch 
interrupt on or off. 


SetComplnt( BOOL ) 

Deciaration: 

void SetCompint( BOOL) 

SetCompIntO turns the function complete 
interrupt on or off. 


Set SelTimeout Into 

Declaration: 

void SetSelTimeoutint( BOOL) 

SetSelTimeoutIntO turns the select time out 
interrupt on or off. 


SetSelIntO 


Declaration: 

void SetSellnt( BOOL) 


SetSelIntO turns the select interrupt on or off. 


SetGrossErrIntO 


Declaration: 

void SetGrossErrlnt( BOOL) 


SetGrossErrIntO turns the SCSI gross error 
interrupt on or off. 


SetUXDiscIntO 


Declaration: 

void SetUXDisclnt( BOOL) 

SetUXDiscIntO turns the Unexpected 
disconnect interrupt on or off. 


SetRSTIntO 


Declaration: 

void SetRSTInt( BOOL) 


SetRSTIntO turns the RST/ interrupt on or 
off. 


SetParIntO 


Declaration: 

void SetParlnt( BOOL) 

SetParIntO sets the parity error interrupt on or 
off. 
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NCR SCSI SCRIPTS ™ Utilities 


Set286Mode() 

Declaration: 

void Set286Mode( BOOL) 

Set286Mode() puts the chip in 80286 mode 
when ON, otherwise it is in the 80386 mode. 


ClearDMAFifoO 

Declaration: 

void ClearDMAFifoO 

ClearDMAFifoO clears the DMA FIFO. 


SetlOO 

Declaration: 

void SetlO( BOOL) 

SetIO() tells the SIOP to transfer data to an 
I/O mapped device when ON, otherwise 
transfers are to memory mapped devices. 


Set16BitDBus() 

Declaration: 

void Set16BitDBus( BOOL ) 

Setl6BitDBus() causes the SIOP to perform 
transfers 16-bits at a time when ON, otherwise 
transfers are 32-bits at a time. 


SetFixedAddrO 

Declaration: 

void SetFixedAddr( BOOL) 

SetFixedAddr() disables the address pointer 
in the DNAD register so that it is ON, it will 
not increment 


SetAbortIntO 

Declaration: 

void SetAbortlnt( BOOL) 

SetAbortIntO makes the SIOP drive the INT/ 
signal when an abort condition is encountered 
and it is set to ON. 


SetlNTInstJntO 

Declaration: 

void SetlNTInstlnt( BOOL) 

SetlNTInstlntO allows the SIOP to drive the 
INT/ signal when it encounters an INT 
instruction in a script and it is set to ON. 


SetWatchDoglnt( ) 

Declaration: 

void SetWatchDogint( BOOL) 

SetWatchDogIntO allows the SIOP to drive 
the INT/ signal when the watch dog timer 
decrements to 0 and it is set to ON. 


SetlllegallnstIntO 

Declaration: 

void Setlllegallnstlnt( BOOL) 

SetIUegalInstInt() allows the SIOP to drive 
the INT/ signal when an illegal instruction is 
encountered in a SCRIPT and it is set to ON. 


Set16BitScr[pts() 

Declaration: 

void Set16BitScripts( BOOL) 

Setl6BitScripts() makes the SIOP fetch script 
instructions 16-bits at a time when set to ON. 
Otherwise fetches are 32-bits at a time. 
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NCR SCSI SCRIPTS ™ Utilities 


SelClkFreqO 

Declaration: 

void SelClkFreq( UBYTE) 


SetClkFreq() send the clock speed being used 
by the system to the SIOP. It accepts 1 of 3 
values; SLOW, MED, or FAST. 


/* 

0 

FAST 

37.51 

to 

50 MHz 

/♦ 

1 

MED 

25.01 

to 

37.5 MHz 

/♦ 

2 

SLOW 

16.67 

to 

25 MHz 


SetHOSTIDO 

Declaration: 

BOOL SetHOSTID( UBYTE) 

SetHOSTIDO accepts a byte value to be placed 
into the SCID register. It will not allow a value 
of 255 (FF hex) to be placed into this register 
since the SIOP cannot talk to itself. 


SetParityO 

Declaration: 

void SetParity( BOOL) 

SetParityO, when ON, the SlOP checks the 
data bus for odd parity when receiving across 
the SCSI bus. 


SetAutoATNO 

Declaration: 

void SetAutoATN( BOOL) 

SetAutoATNO, the SIOP asserts the ATN/ 
signal when a parity error is detected and it is 
ON. 


SetSlowBusO 

Declaration: 

void SetSlowBus( BOOL) 

SetSlowBusO, the SIOP adds 1 extra clock 
cycle to the data setup time when it is ON. 


GetPhysAddrO 

Declaration: 

ULONG GetPhysAddr{ UBYTE far *) 

GetPhysAddrO accepts a far pointer in the 
80x86 format. Then It takes the segment 
portion, multiplies it by 16 and adds it to the 
offset portion to return a physical address. 


PatchLabelsO 

Declaration: 

void PatchLabels(Base, PatchArray, Count) 
ULONG Base[]. PatchArray[]; 
ULONG Count; 

PatchLabelsO patches a script that references 
labels within that script. Three ULONGs are 
passed to it. 

The first ULONG is a pointer to the 
ULONG array SCRIPT that is going to be 
manipulated. 

The second is a pointer to the ULONG 
PatchArray (LABELPATCHES), the array 
whose elements contain the offsets into the 
script to be manipulated. 

The third ULONG is the count of the 
number of elements in the patch array. 
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NCR SCSI SCRIPTS ™ Utilities 


PatchRelativeO 

Declaration; 

void PatchReiative (ScriptBase, RelBase, 
ReiArray, Count) 

ULONG ScriptBasei ], RelArray[ ]; 
ULONG ReiBase, Count; 

PatchRelative() requires a little programmer 
input. It is very sirnilar to PatchLabelsQ. 
Passed to it are 

a pointer to the ULONG Script array, 

the physical relative data base address, 

a pointer to the ULONG relative Data 
array, and 

a count of the number of elements in the 
relative array. 


PatchIDO 

Declaration: 

void PatchlD(lnstructions, Location, Value) 
ULONG far ‘Instructions; 
ULONG Location, Value; 


PatchPhaseO 


Declaration: 

void PatchPhase (Instructions, Location, 
Value) 

ULONG far ‘Instructions; 
ULONG Location, Value; 
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Chapter 5 

The NCR SCSI SCRIPTS™ Language Syntax 


Notation 

{ } Something enclosed in curly 

braces is optional. 

{ " The item enclosed in the curly 

braces can be repeated as often 
as desired. 


KEYWORD A word in all upper case is a 
keyword. Case is ignored by 
the compiler when looking for 
keywords. 


Phase must be replaced with only one of the 
following keywords: 


MSG_IN, 

MSG.OUT, 

DATA.IN, 

DATA_OUT, 

CMD, 

STATUS, 

RES4, 

RES5 


The word ‘address’ means a 32-bit 
number. 


The word ‘value’ means a 32-bit number. 
The word ‘count’ means a 24 bit number. 


An 'expression' may be used in any place that 
a numeric value would normally be used. The 
value of all 'expressions' are automatically 
extended to 32-bits. When expressions are 
used in a context where the evaluated value is 
less then 32-bits, the least significant bits will 
be used. For instance, if an 'expression' is 
used to represent a count for a move 
instruction, the evaluated value will be 
truncated to 24 bits. Notification that the 
expression has been truncated will occur if the 
value of the expression is changed. 

The word ‘name’ represents a string of one 
or more consecutive characters chosen from 
the letters, the numbers, the underscore, and 
the dollar sign. Names used for labels, 
externals, and variables in the relative data area 
are passed on to the Host development 
system. 

If the Host development system has 
restrictions on the format of such names, it is 
the responsibility of the SCSI SCRIPTS 
writer's to avoid using such names. For 
example, Turbo C, which is used as the Host 
development system for this application, does 
not allow names to begin with a digit or to 
contain a doUar sign. Therefore, the SCSI 
SCRIPTS writer for DOS and Turbo C should 
avoid using names of this form. 


The word ‘id’ means an eight bit number that 
has exactly one bit set. 

The word ‘data’ means an eight bit number. 

The word 'expression' denotes a 
mathematical expression with the form: 

<identifier> [<addop> <identifier>]* 

<identifier> is any valid variable name or a 
numeric constant. 

<addop> is the '+' or'-' character to 
denote addition or subtraction respectively. 


Input Format 

SCSI SCRIPTS consist of a series of lines. 
Blank lines, lines containing only white space, 
and anything after a semi-colon on an input 
line are ignored by the front end. 

The compiler is “token” oriented. It reads the 
input stream and splits it up into tokens. 

White space and anything from a semicolon to 
the end of the line is not part of any token, and 
is ignored by the first pass of the compiler. 
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The NCR SCSI SCRIPTS™ Language Syntax 


There are two types of tokens. A token is any 
string of consecutive letters, numbers, dollar 
signs, or underscores; a character can be part 
of Ol^Y one token. The input stream is split 
into tokens to minimize the number of tokens. 
For example, the string “abc” would be treated 
as one token () rather than multiple 

tokens (V’and 

The second type of token consists of 
characters that are not part of odier tokens. 
Anything that is not a letter, a digit, an 
underscore, or a dollar sign becomes a token. 
For example, the string 

“xxx=0x123 ; assign value to xxx” 

contains three tokens. 

xxx 

0x123 


Numeric values may be specified in decimal, 
hexadecimal, octal, or binary. 

Decimal numbers are specified by a string 
of digits not beginning with zero. 

Hex numbers are specified by a string 
consisting of “Ox” or “OX” and the hex 
digits of the number. Both upper and 
lower case are allowed. 

A binary number is similar to a hex 
number, except that “Ob” or “OB" is used 
instead of “Ox” or “OX”. 

An octal number is specified by a “0” 
followed by the octal digits. 


Language Directives 

Several keywords provide information to the 
front end about the compilation of the SCSI 
SCRIPTS. They define symbolic names and 
indicate things to be pass^ to the second pass 
of the compiler. 


ENTRY label {,label...} 

The ENTRY keyword indicates that the 
specified labels are SCSI SCRIPTS entry 
points. Their names and values are defined at 
the back end, which will also make them 
available to the Host development system. 


ABSOLUTE name = 

expression {,name = expression...} 

This declares symbolic names for numeric 
values. For example, 

ABSOLUTE bad_cmd = 0x1200” 

allows the name 

bad_cmd 

to be used instead of a number in the SCSI 
SCRIPTS. The SCSI SCRIPTS will be 
compiled as if the number 0x1200 had been 
specified instead of the name “bad_cmd” in 
every instraction that uses “bad_cmd”. 


EXTERNAL name {,name...} 

This tells the compiler that the SCSI SCRIPTS 
will refer to variables with specified names 
that are declared outside of die SCSI 
SCRIPTS. Some host development systems 
are not able to support use of this word and 
SCSI SCRIPTS requiring this feature may not 
be portable to all hosts. 


RELATIVE name = 

expression {,name = expression...} 

Use to declare relative data variables. 

name the variable name. 

expression the offset from the start of the 
relative data area where the 
variable is located. 

A name followed by a colon signifies a label. 
Use a label name wherever there is a call for 
an address. 
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Block MOVE Command 


The SCSI SCRIPTS Instructions 

When an instruction calls specifies a count, 
use a 24-bit number or a symbolic constant 
(declared using the ABSOLUTE keyword). 

When an instruction requires an address, use 

a 32-bit number, 

the label name, 

the variable name in the relative data area 
(previously declared with the 
^LATTVE keyword), or 

the external variable name (previously 
declared with the EXTERNAL 
keyword). 

Labels, external variables, and relative 
variables all share the same name space. If a 
name is declared more than once, the front end 
resolves the conflict. If a problem possibly 
exists, a warning will be issued. 

If the address field of an instruction contains 
an undefined name, then the front end 
assumes that it refers to a label that will be 
defined later. This is called forward 
referencing. If the name is defined later as an 
external or relative variable, this will create a 
name conflict and the front end will resolve it 
A possible problem warning is issued. 


There are several forms of the Block Move 
instmction. 

address Specify the address and byte count 
count fields of the instruction. If the 

optional keyword PTR is present, 
then the indirect bit wiU be set. 

Phase Specifies the phase field of the 

instruction 

WITH or Specify the Block Move function 

WHEN codes 

WITH signals the target role 
which sets the phase values 

WHEN is the initiator "test for 
phase" feature 

The 53C700 waits for a valid phase (initiator) 
or drives the phase lines (target). In the 
initiator role, it performs a compare by 
looking for a match between the phase 
specified in the SCRIPT and the actual value 
on the bus. If the phases do not match, an 
external interrupt occurs. Data is then 
transferred in or out according to the phase 
lines. When the count goes to zero, the next 
sequential SCRIPTS instruction is fetched. 


MOVE count, { PTR } address, WITH Phase 
MOVE count, { PTR } address, WHEN Phase 
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JUMP Command 

The conditional JUMP instractions all have the 

same general form. 

Address The SCSI SCRIPTS address that 
will be transferred to if the JUMP is 
taken. 

WHEN Sets the Wait bit in the SEQ CNTL 
field. 

IF Do not set the Wait bit 

If NOT follows WHEN or IF, then 
the True/False bit of the SEQ CNTL 
field is not set; otherwise, the bit 
will be set. 

Phase When present, the compare Phase 
bit of SEQ Cr'hx wiU be set; 
otherwise, it will be cleared. 

data When present, the compare Data bit 

of SEQ CNTL will be set; 
otherwise, it wiU be cleared. 


If both ‘Phase’ and ‘data* are 
specified, they must be in that order 
and they must be separated by the 
keyword AND. 

ATN The target role version which is 

required to test whether the initiator 
has set ATN on the bus. 

NOT Used for the inverse test of WHEN 
and IF. "NOT Phase OR data" is 
the negation of "Phase AND data". 

MASK Always use with an 'AND' or 'OR' 
keyword. The data following the 
keyword 'MASK' allows a 
SCRIPT to selectively compare the 
bits within the data byte. 

Any bits that are ON eliminate the 
corresponding bit in the data byte at the time of 
the compare. Use this 'binary sort' to quickly 
determine the value of incoming bytes. For 
example, a mask of '7F’ and a data compare 
of '80' allows the SCRIPTS processor to 
determine if the high order bit is ON. 


NOP 

JUMP address 

JUMP address, IF ATN 

JUMP address, IF Phase 

JUMP address, IF data 

JUMP address, IF data, AND MASK data 

JUMP address, IF ATN AND data 

JUMP address, IF ATN AND data, AND MASK data 

JUMP address, IF Phase AND data 

JUMP address, IF Phase AND data, AND MASK data 

JUMP address, WHEN Phase 

JUMP address, WHEN data 

JUMP address, WHEN data ,AND MASK data 

JUMP address, WHEN Phase AND data 

JUMP address, WHEN Phase AND data, AND MASK data 

JUMP address, IF NOT ATN 

JUMP address, IF NOT Phase 

JUMP address, IF NOT data 

JUMP address, IF NOT data, AND MASK data 

JUMP address, IF NOT ATN OR data 

JUMP address, IF NOT ATN OR data, AND MASK data 

JUMP address, IF NOT Phase OR data 

JUMP address, IF NOT Phase OR data, AND MASK data 

JUMP address, WHEN NOT Phase 

JUMP address, WHEN NOT data 

JUMP address, WHEN NOT data, AND MASK data 

JUMP address, WHEN NOT Phase OR data 

JUMP address, WHEN NOT Phase OR data, AND MASK data 


NCR 53C700, Programmer's Guide 


5-4 


2/23/90 




The NCR SCSI SCRIPTS™ Language Syntax 


CALL Command 

All conditional CALL instructions have the 

same general form. 

Address The SCSI SCRIPTS address 

transferred to if the JUMP is taken. 

WHEN Set the Wait bit in the SEQ CNTL 
field. 

IF Do not set the Wait bit 

If WHEN or IF are followed by NOT, 
then the True/False bit of the SEQ 
CNTL field is not set. Otherwise, 
the bit will be set. 

Phase When present, the compare Phase 
bit of SEQ CNTL will ^ set; 
otherwise, it will be cleared. 

data When present, the connate Data bit 

of SEQ CNTL will be set; 
otherwise, it will be cleared. 


If both Phase and data are specified, 
they must be in that order and they 
must be separated by the keyword 
AND. 

ie. ...WHEN Phase AND data... 

ATN The target role version which is 

required to test whether the initiator 
has set ATN on the bus. 

NOT Used for the inverse test of WHEN 
and IF. 

"NOT Phase OR data" is the negation 
of "Phase AND data". 

MASK Always use with an 'AND' or 'OR' 
keyword. The data following the 
keyword MASK allows a SCRIPT to 
selectively compare the bits within 
the data byte. 

Any bits that are ON eliminate the 
corresponding bit in the data byte at the 
compare. Use this 'binary sort' to quickly 
determine value of incoming bytes. For 
example, a mask of 'TF'and a data compare of 
'80' allows the SCRIPTS processor to 
determine if the high order bit is ON. 


CALL address 

CALL address, IF ATN 

CALL address, IF Phase 

CALL address, IF data 

CALL address, IF data, AND MASK data 

CALL address, IF ATN AND data 

CALL address, IF ATN AND data, AND MASK data 

CALL address, IF Phase AND data 

CALL address, IF Phase AND data, AND MASK data 

CALL address, WHEN Phase 

CALL address, WHEN data 

CALL address, WHEN data, AND MASK data 

CALL address, WHEN Phase AND data 

CALL address, WHEN Phase AND data, AND MASK data 

CALL address, IF NOT ATN 

CALL address, IF NOT Phase 

CALL address, IF NOT data 

CALL address, IF NOT data, AND MASK data 

CALL address, IF NOT ATN OR data 

CALL address, IF NOT ATN OR data, AND MASK data 

CALL address, IF NOT Phase OR data 

CALL address, IF NOT Phase OR data, AND MASK data 

CALL address, WHEN NOT Phase 

CALL address, WHEN NOT data 

CALL address, WHEN NOT data, AND MASK data 

CALL address, WHEN NOT Phase OR data 

CALL address, WHEN NOT Phase OR data, AND MASK data 
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RETURN Command 

All conditional RETURN instractions have the 

same general form. 

Address The SCSI SCRIPTS address that 

win be transferred to if the JUMP is 
taken. 

WHEN Set the Wait bit in the SEQ CNTL 
field. 

IF Do not set the Wait bit 

If WHEN or IF are foUowed by NOT, 
then the True/False bit of the SEQ 
CNTL field is not set. Otherwise, 
the bit win be set. 

Phase When present the compare Phase bit 
of SEQ CNTL win be set; 
otherwise, it wiU be cleared. 

data When present, the compare Data bit 
of SEQ CNTL win be set; 
otherwise, it wiU be cleared. 


If both Phase and data are specified, 
they must be in that order and they 
must be separated by the keyword 
AND. 

ATN The target role version which is 

required to test whether the initiator 
has set ATN on the bus. 

NOT Used for the inverse test of WH EN 

and IF. "NOT Phase OR data" is the 
negation of "Phase AND data". 

MASK Always use with an 'AND' or 'OR' 
keyword. The data foUowing the 
keyword 'MASK' allows a SCRIPT 
to selectively compare the bits 
within the data byte. 

Any bits that are ON eliminate the 
corresponding bit in the data byte at the time of 
the compare. Use this 'binary sort' to quickly 
determine value of incoming bytes. For 
example, a mask of 'TF'and a data compare of 
'80' allows the SCRIPTS processor to 
determine if the high order bit is ON. 


RETURN 

RETURN, IF ATN 

RETURN, IF Phase 

RETURN, IF data 

RETURN, IF data, AND MASK data 

RETURN, IF ATN AND data 

RETURN, IF ATN AND data, AND MASK data 

RETURN, IF Phase AND data 

RETURN, IF Phase AND data, AND MASK data 

RETURN, WHEN Phase 

RETURN, WHEN data 

RETURN, WHEN data, AND MASK data 

RETURN, WHEN Phase AND data 

RETURN, WHEN Phase AND data, AND MASK data 

RETURN, IF NOT ATN 

RETURN, IF NOT Phase 

RETURN, IF NOT data 

RETURN, IF NOT data, AND MASK data 

RETURN, IF NOT ATN OR data 

RETURN, IF NOT ATN OR data, AND MASK data 

RETURN, IF NOT Phase OR data 

RETURN, IF NOT Phase OR data, AND MASK data 

RETURN, WHEN NOT Phase 

RETURN, WHEN NOT data 

RETURN, WHEN NOT data, AND MASK data 

RETURN, WHEN NOT Phase OR data 

RETURN, WHEN NOT Phase OR data, AND MASK data 
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INTERRUPT Command 

All conditional INT instructions have the same 
general form. 

Address The SCSI SCRIPTS address that 

will be transferred to if the JUMP is 
taken. 

WHEN Set the Wait bit in the SEQ CNTL 
field. 

IF Do not set the Wait bit 

If WHEN or IF is followed by NOT, 
then the True/False bit of the SEQ 
CNTL field is not set Otherwise, 
the bit will be set. 


If both Phase and data are specified, 
they must be in that order and they 
must be separated by the keyword 
AND. 

ATN The target role version which is 

required to test whether the initiator 
has set ATN on the bus. 

NOT Used for the inverse test of WH EN 
and IF. "NOT Phase OR data" is the 
negation of "Phase AND data". 

MASK Always use with an AND or OR 
keyword. The data following the 
keyword MASK allows a SCRIPT to 
selectively compare the bits within 
the data byte. 


Phase When present, the compare Phase 
bit of SEQ CNTL will be set; 
otherwise, it will be cleared. 

data When present, the compare Data bit 
of SEQ CNTL will be set; 
otherwise, it will be cleared. 


Any bits that are ON eliminate the 
corresponding bit in the data byte at the 
compare. Use this ’binary sort' to quickly 
determine value of incoming bytes. For 
example, a mask of 'TF'and a data compare of 
'80' allows the SCRIPTS processor to 
determine if the high order bit is ON. 


INT address 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address, 
INT address. 


IF ATN 
IF Phase 
IF data 

IF data, AND MASK data 
IF ATN AND data 

IF ATN AND data, AND MASK data 

IF Phase AND data 

IF Phase AND data, AND MASK data 

WHEN Phase 

WHEN data 

WHEN data, AND MASK data 

WHEN Phase AND data 

WHEN Phase AND data, AND MASK data 

IF NOT ATN 

IF NOT Phase 

IF NOT data 

IF NOT data, AND MASK data 

IF NOT ATN OR data 

IF NOT ATN OR data, AND MASK data 

IF NOT Phase OR data 

IF NOT Phase OR data, AND MASK data 

WHEN NOT Phase 

WHEN NOT data 

WHEN NOT data, AND MASK data 

WHEN NOT Phase OR data 

WHEN NOT Phase OR data, AND MASK data 
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SCSI I/O Commands 


SELECT {ATN} ID, Address 

Initiator mode function 0. 

If ATN is present, the “select with ATN” 
bit is turned on. ‘id’ specifies the 
destination SCSI ID. 


SET ACK 

Function 3 with the ACK bit set in the 
Flags field. 

SET ATN 

Function 3 with the ATN bit set in the 
Flags field. 


RESELECT id, address 


SET ACK and ATN and TARGET 


Target mode function 0 


WAIT DISCONNECT 
Initiator mode function 1 


Function 3 with ACK, ATN, and 
TARGET bits set in the flag field. All 
three or any two of the keywords (ACK, 
ATN, or TARGET) may be used. 


DISCONNECT 

Target mode function 1 


CLEAR TARGET 

Function 4 with the target bit set in the 
flags field. 


WAIT RESELECT address 


CLEAR ACK 


Initiator mode function 2 


Function 4 with the ACK bit set in the 
Flags field. 


WAIT SELECT address 

Target mode function 2 
If the 53C700 is connected as an initiator, 
the following set and clear commands will 
have no meaning (the SCSI target role is 
not active) and should not be used. 


SET TARGET 

Function 3 with the target bit set in the 
flags field. 


CLEAR ATN 

Function 4 with the ATN bit set in the 
Flags field. 


CLEAR ACK and ATN and TARGET 

Function 4 with ACK, ATN, and 
TARGET bits set in the Flags field. All 
three or any two of the keywords (ACK, 
ATN, or TARGET) may be used. 
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Chapter 6 

SCSI SCRIPTS ™ to Support Use of Scatter/Gather 


Virtual memory schemes are common in 
todays systems, they are used to keep user 
data in small, manageable pages in main 
memory. Memory management units track 
actual, physical locations. This memory 
scheme is called scatter/gather because user 
data is scattered through memory and gathered 
for a write to disk. One I/O may include 
several pages, so current SCSI ports must re¬ 
instruct the DMA controller at the beginning of 
each user data page. 

The extra time required to re-instmct for each 
page causes some delay for the external 
processor interrupt and DMA setup time. A 
potentially undesirable side effect occurs when 
the delay makes the disk slip a revolution, 
because there is no place to put data coming 
off the media. 

The 53C700 has an efficient solution to the 
scatter/gather performance degradation 
problem. Each page of user data is 
represented by a Block Move command. The 
oiily overhead required to move to the next 
page of data is a SCSI SCRIPTS fetch (500 
nanoseconds). No firmware interrupt is 
required (normally a minimum of 80 
microseconds in a system environment). Nor 
is a firmware instmction required to re-instmct 
a DMA controller. 


Chapter 7 contains a SCSI SCRIPTS model 
for the scatter/gather situation. First, separate 
the set of Block Move commands that are 
required to process the user data and code the 
SCSI SCRHTS to call this user data section 
to move. Determine a maximum number of 
pages per I/O and code one SCSI SCRIPTS 
Block Move for each possible page. At the 
start I/O time, the logical I/O routine 
determines exactly how many block moves are 
required and patches a return command over 
the next SCSI SCRIPTS command after the 
last required Block Move command. The 
group of Block Move commands is called, the 
correct number of moves is performed, and 
the return is executed. At the completion of 
the I/O, the return is overwritten with a Block 
Move to prepare the set of Block Move 
commands for the next I/O. 

The 53C700 can process scatter/gather 
requests in a very simple manner and 
simultaneously, dramatically reduce I/O 
overhead. 
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Chapter 7 

NCR SCSI SCRIPTS™ for an Initiator 


; Definition area INITIATOR ROLE 

; Target Device LD. to be fixed at Start I/O time. 
EXTERNAL device 

; Ten byte buffer for sending messages 

EXTERNAL sendmsg 

; Ten byte buffer for receiving messages 
EXTERNAL rcvmsg 

; Number of message bytes to send after selection 

EXTERNAL idcount 

; Number of command bytes 

EXTERNAL cmd_count 

; Buffer for the SCSI command 

EXTERNAL cmd.adr 

; Number of user data bytes 

EXTERNAL data_count 

; Address of user data buffer 

EXTERNAL data_adr 

; Error - not message out after selection 
ABSOLUTE errl = OxOffOl 

; Error — unexpected SCSI phase before command phase 

ABSOLUTE err2 = 0x0ff02 

; Error -- unexpected SCSI phase after a command transfer 

ABSOLUTE err3 = OxOffOS 

Error — not msg in phase after status phase 
ABSOLUTE err4 = 0x0ff04 

; No Error -- good I/O 
ABSOLUTE ok = OxOffOO 

; SCSI status returned is check condition 
ABSOLUTE check_cond = OxOfffe 

; SCSI status returned is busy 
ABSOLUTE busy = OxOfffd 

; SCSI status returned is reservation conflict 

ABSOLUTE reserved = OxOfffc 
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NCR SCSI SCRIPTS™ for an Initiator 


; SCSI status returned is unknown 
ABSOLUTE bad_status = OxOfffb 

; Error — unexpected phase after a data transfer 
ABSOLUTE err5 = OxOffOS 

; Error — unexpected msg in phase before command phase 
ABSOLUTE err6 = 0x0ff06 

; Error -- extended msg present before a command phase 
ABSOLUTE eiT? = OxOffO? 

; Error -- save data pointers before a command phase 
ABSOLUTE err8 = 0x0ff08 

; Error — disconnect before command phase 
ABSOLUTE err9 = 0x0ff09 

; Error — save data pointers after the command phase 
ABSOLUTE eirlO = OxOfflO 

; Error ~ unexpected msg after command phase 
ABSOLUTE eiTl 1 = OxOff 11 

; Error — extended message present after the command phase 
ABSOLUTE errl2 = 0x0ffl2 

; Error — disconnect after a command phase 
ABSOLUTE errl3 = OxOfflS 

; Error — save data pointers after a data transfer 

ABSOLUTE errl4 = 0x0ffl4 

; Error -- unexpected message after a data transfer 

ABSOLUTE eirl5 = OxOfflS 

; Error ~ extended message after a data transfer 
ABSOLUTE errI6 = 0x0ffl6 

; Error — disconnect after a data transfer 

ABSOLUTE eiTl? = OxOffl? 

; Error - Message in not received after reselection 

ABSOLUTE eiTl8 = 0x0ffl8 

; Error — Data in phase after reselection and i.d. msg rcvd 
ABSOLUTE errl9 = 0x0ffl9 

; Error — Data out phase after reselection and i.d. msg rcvd 
ABSOLUTE err20 = OxOffZO 
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; Error ~ Msg in phase after reselection and i.d. msg rcvd 
ABSOLUTE err21 = OxOfOl 

; Error -- Status phase after reselection and i.d. msg rcvd 
ABSOLUTE err22 = 0x0ff22 

; Error -- Msg out phase after reselection and i.d. msg rcvd 
ABSOLUTE eiT23 = 0x0ff23 

; Error — Unknown phase after reselection and i.d. msg rcvd 
ABSOLUTE err24 = 0x0ff24 

; Error - Selected as a target 
ABSOLUTE err25 = OxOff25 

; Error ~ Unexpected message rcvd instead of command complete 
ABSOLUTE err26 = 0x0ff26 

; SCSI I/O entry point. This address must be loaded into the 
; 53C700 before initiating a SCSI I/O. 

ENTRY start_up 


; SCRIPTS AREA 

; This is the entry point for a SCSI I/O 
start_up: 

; This is the SCRIPT for a standard SCSI I/O 

; First, select the device with attention and go to an 
; alternate reselect address. If a reselection or selection 
; happens before the selection can execute, the chip will 

; change roles if required. 

SELECT ATN device resel_adr 

; If the next phase is status, go to end. Wait for valid 

; phase before performing the comparison. 

JUMP end WHEN STATUS 

; If not msg out phase, interrupt. Do not wait for phase. 
INT errl IF NOT MSG.OUT 
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; Label for retry loop to resend I.D. msg on error 

^ 5k3k3fC5k5k3fC3fe5k3k%ik5k5k2k3ff5k3k5k^3fff5k3|C!k3|t%5fC3fC3|f3|C2|ff3fC5kH<3|C5fC3fc:Jc4e3fff3iC3k5|s5JC5|f5k!|ff3k3k 

retry: 

; The expected case after selection is LD. message out to the 
; device. Move the LD. message from the send message buffer. 
; Do not wait for a phase change. 

MOVE idcount sendmsg when MSG_OUT 

; If the target remains in the message out phase after the 
; initial messages have been sent to the device, retransfer 
; the messages. Wait for a valid phase (req asserted), 

JUMP retry WHEN MSG_OUT 

; Now check for all expected phases. 

JUMP end IF STATUS 

; Process a message in before the command phase here 
JUMPmsgl IFMSG_IN 

; If it is not status, msg in, or command, stop 
; Interrupt if not command phase 

INTerr2IFNOTCMD 

; Transfer command bytes to the host 

MOVE cmd_count cmd_adr when CMD 

; Determine what is coming next. Is there a message in after 
; the command phase? 

JUMP msg2 WHEN MSG_IN 

; Status phase after the command? 

JUMP end IF STATUS 

; Check for data in phase 

JUMP input_data IF DATA_IN 

; Is this a data out phase? 

JUMP output_data IF DATA_OUT 

; Error — an unexpected phase after a command transfer 
INT err3 


V. 
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end: 


Label to process the status phase 


; Move the status byte in to the buffer area 

MOVE 1 status_adr when STATUS 

; NOTE: an alternative at this point is to determine what the 
; status byte is and jump to a set of routines that will 
; process the command complete message, physical disconnect, 
; and then interrupt with the appropriate status byte error 
; value. Here, the algorithm interrupts if good I/O is not 
; the status byte returned by the target. 

; Was there a check condition 

INT check_cond IF 0x02 

; Is the device busy 

INT busy IF 0x08 

; Is the device reserved 

INT reserved IF 0x018 

; Interrupt for unknown state 

INT bad_status IF NOT 0x00 

; Status value is good I/O, so process the command complete 
; Stop if the next phase is not message in. 

INT err4 WHEN NOT MSG_IN 

; Message in if here. It should be a command complete. 

MOVE 1 rcvmsg when MSG_IN 

; Process the message if it is not a command complete 
INT IF NOT 0x00 

; At this point, instead of interrupting, the best course 
; would be to examine the message received and react, or to 
; interrupt with a more specific error code. 

; Command complete was received, acknowledge it 
CLEAR ACK 

; A physical disconnect should be next 

WATT DISCONNECT 

; Good VO if here 
INT ok 
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; This the data out section of the algorithm 

outptit_data: 

MOVE data_count data_adr when D ATA_OUT 

J If a scatter/gather requirement exists, then this section 
; can be multiple block moves to allow for multiple segments 
; of data. Also, this section could actually be a jump to a 
; group of block moves that can be patched appropriately at 

; start I/O for te number of segments needed. The overhead 
; between segment block moves is 500-600 nanoseconds. 


; Process what comes after the data transfer 
check_out: 

; Status phase is the normal next step 
JUMP end WHEN STATUS 


; Is there a message in phase after dita transfer 
JUMP msgS IF MSG_IN 

; Unexpected phase detected after data transfer 
INTerrS 


; This is the data in phase portion of the algorithm 
input_data: 


; If a scatter/gather requirement exists, then this section 

; can be multiple block moves to allow for multiple segments 
; of data. Also, this section could aetiially be a jump to a 
; group of block moves that can be patcM appropriately at 
; start I/O for the number of segments needed. The overhead 

; between segment block moves is 500^00 nanoseconds. 

MOVE data_cOunt data_adr when DATA_IN 

; Go check the phase after data in 
JUMP check_it 
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; Process a message in before the command phase 

msgl: 

MOVE 1 rcvmsg when MSG_IN 

; Is this an extended message? 

JUMP ext_msgl IF 0x01 

; Is this save data pointers? Interrupt with ACK set 
INTerr8IF0x02 

; Is this a disconnect? 

JUMP disci IF 0x04 

; Interrupt if any other message with ACK set 
INT err6 

; Message is an extended message 
ext_msgl: 

; Acknowledge the message just received 

CLEAR ACK 

; Move two more messages into the buffer to get the extended 
; message length and opcode for the processor to have 
; available on the interrupt. 

MOVE 2 ext_buf when MSG_IN 

; Interrupt the processor 
INT err? 

; Message is a disconnect 
disci: 

; Acknowledge the disconnect message 
CLEAR ACK 

; Disconnect before the command if here 
WATT DISCONNECT 

; Interrupt the processor on a disconnect 
INT err9 
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NCR SCSI SCRIPTS™ for an Initiator 


; Message in after the command phase 

^ )k3k9k3k^3{e:|e:|c9ic)|e9k^iie3|c9kif(^3ie^^:{c^^:|c^^^3k^3|c^3k^4e^3fc 

msg2: 

MOVE 1 rcvmsg when MSG_IN 

; Is this an extended message? 

JUMP ext_msg2 IF 0x01 

; Is this save data pointers? Interrupt with ACK set. 

INTerrl0IF0x02 

; Is this a disconnect? 

JUMP disc2 IF 0x04 

; Interrupt if any other message with ACK set 

INT errl 1 

; Message is an extended message 

ext_msg2: 

; Acknowledge the message just received 

CLEAR ACK 

; Move two more messages into the buffer to get the extended 
; message length and opcode for the processor to have 

; available on the interrupt. 

MOVE 2 ext_buf when MSG_IN 

; interrupt the processor 

INT errl2 

; Message is a disconnect 

disc2: 

; Acknowledge the message 

CLEAR ACK 

; Disconnect after the command if here 

WATT DISCONNECT 

; Interrupt the processor on a disconnect 

INTerrlS 
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NCR SCSI SCRIPTS™ for an Initiator 


; Message in after the data transfer phase 

msg3: 

MOVE 1 rcvmsg when MSG_IN 

; Is this an extended message? 

JUMP ext_msg3 IF 0x01 

; Is this save data pointers? Interrupt with ACK set 

INTerrl4IF0x02 

; Is this a disconnect? 

JUMP disc3 IF 0x04 

; Interrupt if any other message with ACK set 

INT err 15 

; Message is an extended message 
ext_msg3: 

; Acknowledge the message just received 

CLEAR ACK 

; Move two more messages into the buffer to get the extended 

; message length and opcode for the processor to have 

; available on the interrupt. 

MOVE 2 ext_buf when MSG_IN 

; Interrupt the processor 

INT errl6 

; Message is a disconnect 

disc3: 

; Acknowledge the message 

CLEAR ACK 

; Disconnect before the data transfer if here 
WATT DISCONNECT 

; Interrupt the processor on a disconnect 

INT errl? 
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NCR SCSI SCRIPTS™ for an Initiator 


; This is the section of code to process a reselect or select 
; when a select I/O command was executed 
> 

reseLadr: 

; Wait for reselect as the most probable event 

WATT RESELECT select.adr 

; The initiator was reselected, so process the possibilities 
INT errlS WHEN NOT MSG.IN 

; I.D. message in is the only expected SCSI phase here 
MOVE 1 rcvmsg when MSG_IN 

; At this point, if the system integrator knows the possible 
; SCSI device LD.’s possible, the algorithm can compare for 
; each known LD. and react accordingly. An I/O could even be 
; restarted if the SCSI bus configuration is exactly known. 

; Data in phase after reselection and i.d. transfer 
INT errl9 WHEN DATA_IN 

; Data out phase after reselection and i.d. transfer 
INT err20 IF D ATA_OUT 

; Message in phase after reselection and i.d. transfer 

INTerr21IFMSG_IN 

; Status phase after reselection and i.d. transfer 
INT err22 IF STATUS 

; Message out phase after reselection and i.d. transfer 
INT err23 IF MSG_OUT 

; Unknown phase after reselection and i.d. transfer 
INTerr24 
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NCR SCSI SCRIPTS™ for an Initiator 


; The chip was in an initiator role, but it has been selected 
; by another device on the SCSI bus. It is now in the target 

; role. One could implement the complete SCSI SCRIPTS target 

; algorithm here, or simply interrupt with an error message. 

select_adr: 

INT err25 

; Definition Area TARGET ROLE 

^ 5k 5k5k 3|C5|e:k5k5k5k3k3k5k5k5|C3|C5k^5|C5k5iC5k5k5!t5k5fc 

;* The following are variable data values provided * 

;* external to the compiler and resolved at run-time * 

^ %3|C3|C3k5k5k5k5k5k3k5k5je3k5k%3k5k5k5k5K5iC5jC 

; Buffer area where the initiator device i.d. is kept 
EXTERNAL device 


; Message out buffer area 

EXTERNAL msg_biif 

; Command byte buffer area 

EXTERNAL cmd.buf 

; Input message buffer 

EXTERNAL msg_buf2 

; Buffer address for the initiator i.d. 
EXTERNAL initiator 

; Count of user data bytes to be moved 
EXTERNAL data_count 

; Address of the user data buffer 

EXTERNAL data_addr 
; Target got reselected 

; Address of the status buffer 

EXTERNAL stat_adr 
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NCR SCSI SCRIPTS™ for an Initiator 


^5|c 

;* Absolute values are stored in DNAD Register * 

;* for purposes of interrupt processing * 

3|<Jk3iC5fCS|C5fC3|C3k3k3|<5k3|<3jC3f*%3k3k3k3k3|e3k3fe3kifc5k5kik 

ABSOLUTE errorl = OxOffOl 

; ATN is on after the i.d. message is sent in to the initiator 
ABSOLUTE errorl = OxOffOl 

; ATN is on after the command b3^es are sent to the initiator 
ABSOLUTE errors = OxOffOS 

; Atn is on after the disconnect message is sent to the ;initiator 
ABSOLUTE eiror4 = 0x0ft04 

; ATN on after i.d. message sent to the initiator after a 
; reselect operation is complete 
ABSOLUTE errors = OxOffOS 

; ATN is on after user data is sent into the initiator 
ABSOLUTE error6 = 0x0ff06 

; ATN is on after the status byte is sent 
ABSOLUTE error? = OxOffO? 

; ATN is on after the command complete message is sent 

ABSOLUTE errors = OxOffOS 

; Entry Point for the target role 
ENTRY start_up 

; Entry point for a target reselect 

ENTRY resel_in 
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NCR SCSI SCRIPTS™ for an Initiator 


; SCRIPTS AREA 

; This is the entry point for a SCSI target I/O 
start_up: 

; First wait for a selection by the initiator and jump to the 

; alternate address if reselected 

WATT SELECT resel.adr 

; Move the i.d. message into the message buffer 
retry_id: 

MOVE 1 msg_bufWITHMSG_OUT 

; If the initiator sets ATN, go process that condition 
JUMP id_am IF ATN 

continue_id: 

; Move the command bytes in to the target buffer 

MOVE 1 cmd.buf WITH CMD 

; Note that though a 1 is in the command count field, the chip 
; will automatically transfer in the correct number of bytes 
; based on the SCSI command op code. 

; If the initiator sets ATN, go process that condition 
JUMP cmd_atn IF ATN 

continue_cmd: 

; In this algorithm, an automatic disconnect is assumed after 
; the SCSI command is received into the buffer. However, the 
; first byte of the command may be compared against a set of 

; opcode values to determine if this specific command should 

; disconnect or not. 

; Send in the disconnect message 

MOVE 1 msg_buf2 WITH MSG_IN 

; If the initiator sets ATN, go process that condition 

JUMP disc_am IF ATN 

continue_disc: 

; Now get off the bus 

DISCONNECT 
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NCR SCSI SCRIPTS™ for an Initiator 


; Entry point for reselecting the initiator 

resel_in: 

; Perform the reselect and jump to resel_adr if a reselection 
; happens while trying to do the reselect 
RESELECT initiator resel_adr 

; Move the reselect i.d. message into the initiator 
retiy_resel: 

MOVE 1 msg_buf2 WITH MSG_IN 

; If the initiator sets ATN, go process that condition 
JUMP resel_atn IF ATN 

continue_resel: 

; Now move the data b 5 ^es into the initiator 
MOVE data_count data_adr WITH D ATA_IN 

; Note that this could easily be changed to a data out command 

; by patching the phase section of the command, or using a 
; jump command that can be patched to transfer control to a 
; section of code that is either the data out or data in algorithm. 
; If the initiator sets ATN, go process that condition. 

JUMP data_ath IF ATN 

continue_data: 
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NCR SCSI SCRIPTS™ for an Initiator 


If a scatter/gather requirement exists, then this data 
transfer section can be multiple block moves for the 
multiple segments of data. Also, the section could be a 
jump to a group of block moves that had been patched 
appropriately at start I/O for the exact number of segments desired. 


; Now move in the status byte 
MOVE 1 stat.adr WITH STATUS 


; If the initiator sets ATN, go process that condition 
JUMP stat_atn IF ATN 


continue_stat: 


; Move the command complete message in 
MOVE 1 msg_buf2 WITH MSG_IN 

; If the initiator sets ATN, go process that condition 

JUMPcc_atnIFATN 


continue_cc: 


; Now physically disconnect 

DISCONNECT 

; If the wait for select or reselect fails, this is the label 
; for the alternate address 

resel_adr: 

ENT errorl 
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NCR SCSI SCRIPTS™ for an Initiator 


; If the initiator turns on ATN after the i.d. message comes 

; out, this is the code for processing what comes next. 

^ %4e^3i<3kHesk5|e5|<3fe5k3k3k%3k3|e3|e3k5j*3jci|c5|e:|c5ie3|<:|ejfe:(c5jc:fe:jc5jc:^c:fc ♦sk % 

id_atn: 


; Move the message byte fix)m the initiator out to the message buffer 
MOVE 1 msg_bufWITHMSG_OUT 

; At this point, the user may decide to use scripts to program 
; at a very det^ed level or simply interrupt with one user 
; error code. Scripts may be used to check for: 

; • no^op message— ignore and jump to continue 

; • initiator detected error - jump to retry 

; • message parity error - jump to retry 

; • extended message — as a minimum, get the opcode and 

; byte count before interrupting the processor 

INT error2 


; All the ATN subroutines have the same basic function 
cmd_atn: 

MOVE 1 msg^buf WITHMSG_OUT 
INT errors 


disc_atn: 

MOVE 1 msg_buf WITHMSG_OUT 
INT error4 


resel atn* 

MOW 1 msg_buf WTIHMSG.OUT 
INT errors 


data_atn: 

MOVE 1 msg_buf WITHMSG_OUT 
INTerrord 


stat_atn: 

MOVE 1 msg_buf WriHMSG.OUT 
INT error? 


cc_atn: 

MOVE 1 msg_buf WITHMSG_OUT 
INT errors 
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Chapter 8 

Unique Initiator Sequences for the 53C700 


Disk Drive Initiator Sequence 

Arbitrate and Select With Am 

Transfer the LD. message 

Transfer the command bytes 

Accept the message in -- DISCONNECT 

Reselected -- LD. message in 

Data transfer of 1 - 4 user data blocks 

Accept SCSI status byte, COMMAND COMPLETE message and wait for bus free 


53C700 strengths in the disk drive 
environment 


• A large number of commands are typically 
issued to the disk, and the 53C700 offers 
very litde SCSI bus overhead and a 
minimum of time to initiate an I/O in the 
host computer. 

• The 530700 can continue to the next 
scheduled SCSI I/O within SCRIPTS with 
no interrupt to the external processor for 
the following: 

Compare for Good VO stams byte 
Interrupt if non-zero 


• The 53C700 can mask certain disk 
idiosyncrasies. 

For example, if the disk does a SAVE 
DATA POINTERS before the first 
DISCONNECT message after the 
command bytes are transferred, the 
53C700 can be programmed to absorb this 
message with no interrupt to the external 
processor. 


Jump to the next scheduled I/O if the 
status is zero (Good I/O) 
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Unique Initiator Sequences for the 53C700 


Tape Drive Initiator Sequence 

Arbitrate and Select With Atn 

Transfer the I.D. message 

Transfer the command bytes 

Accept the message in ~ DISCONNECT 

Reflected ~ LD. message in 

Data transfer of 16k of user data 

Accept the message in ~ SAVE DATA POINTERS followed by DISCONNECT. 
Reselected -- LD. message in 

Data transfer of 16k of user data 
♦ 

♦ 

* 

Reselected ~ LD. message in 
Data transfer of 16k of user data 

Accept SCSI status byte, COMMAND COMPLETE message and wait for bus free 


Each disconnect (on a 16k boundary) causes 
an interrupt to the external processor if there 
are multiple SCSI devices on the SCSI bus. 
Reselect causes an interrupt in the general 
case. If this were a single device bus or the 
system was designed to perform tape only 
activity on the SCSI bus during backup, then 
the 53C700 could be programmed specifically 
for this system. Knowing the tape drive was 
alone on the bus, the 53C700 could be 
programmed to: 

1) Absorb the SAVE DATA POINTERS. 

2) Execute a SCRIPTS command of wait 
for reselect. 

3) Process the SCSI reselect sequence 
with no interrupts. 

4) Initiate the next 16k user data block 
move. 

5) If there is ever a restore pointers, the 
53C7(X) interrupts to allow the external 
processor to restart the tape I/O. 

The 53C700 allows systems integration 
designs using the SCSI bus with no 
performance impact to VO throughput 


SCSI Character Oriented Device 
in the Initiator Role 

A SCSI port can be dedicated by the system 
designer for terminal control. First, a SCSI 
read command is transferred to the target 
terminal controller. A stream of user data 
typed in at the terminals, plus the inserted 
control bytes in the stream comes back to the 
initiator. A SCRIPT can be written which 
looks at the byte stream coming in and sends 
line control bytes to the processing buffer and 
data bytes to the data buffer. When certain 
control bytes are received, the 53C700 can 
terminate the READ operation and generate a 
unique interrupt to the external processor. 

Writes to the terminal controller can begin 
automatically when a certain read threshold is 
reached. The 53C700 can process the READ 
command cleanup, jump to the WRITE 
command portion of the SCRIPTS, and 
automatically start sending data to the terminal 
controller. The 53C700 can be used in 
unusual areas to offload any processor and 
improve performance. 

Another implementation of the 53C700 is 
SCSI printer design, where WRITE is the 
only operation and control characters also play 
in important role. 
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Chapter 9 

Special Scripts^ Situations 


SAVE DATA POINTERS message 
that can be ignored. 


CASE 1 

An unexpected Phase change occurs in the 
middle of a data transfer. 

The Block Move command was developed to. 
transfer 4K of user data, as well as anomalies 
such as an unexpected phase change after 
transferring 2K of the data. 

Data may be left in the chip on a data out 
phase, so an interrupt is required to: 

1) Clean up the chip on Data Out Phase 

2) Change the data address and byte count 
in the active SCSI SCRIPTS 

3) Receive the message byte via SCSI 
SCRIPTS (eg. load the new entry 
point for resumption of the message in 
operation). 

The routine described in steps 1-3 will receive 
the message byte, verify that the message byte 
is a SAVE DATA POINTERS (if not, 
interrupt the external processor), and jump to 
the SCSI SCRIPTS entry point that will 
resume the data transfer previously 
interrupted. 


CASE 2 

The expected burst size is known ahead of 
time and is extremely predictable. 

At systems integration time, set this burst size, 
so that each Block Move command can equal 
the burst size. The SCSI SCRIPTS logic 
becomes the following: 


• Block Move of burst size. 

• Call subroutine (after waiting) if the 
next phase is not a data phase. (The 
subroutine should process the SAVE 
DATA POINTERS message in and 
return.) 

• Block Move of burst size 

• Call subroutine (after waiting) if the 
next phase is not a data phase. 


Using this logic, all phase changes are 
assumed to come on a Block Move command 
boundary, so no bytes will be left in the chip 
when a phase change occurs. There is a small 
penalty for fetching the call subroutine 
command (500 nsec per SCSI SCRIPTS). 

But a system interrupt (minimum 80 
microseconds) will be saved by avoiding the 
extra interrupt 


CASE 3 

The expected burst size is NOT known ahead 
of time. 

Use the same logic as in Case 2, but make the 
Block Move byte count equal to the device 
block size. The assumption is that a phase 
change will come only on the device's block 
boundary. The SCSI SCRIPTS fetching 
overhead depends on the ratio of the device 
block size to the burst size. However, an 
extra 10 microseconds is small when 
compared to the external processor interrupt 
time of at least 80 microseconds. 


NCR 53C700 Programmer's Guide 


9-1 


2/23/90 





Special Scripts™ Situations 


SAVE DATA POINTERS message 
that must be processed by the 
initiator. 


CASE 1 

A message received during a Block Move 
command offers 2 possibilities: 

1. Data in phase 

2. Data out phase 


Data in phase 

During the data in phase, all bytes in the 
5307^3 are sent to the DMA core and into 
system memory. When no bytes are left in the 
chip, all execution stops and an intermpt is 
generated to the external processor. To save 
tile I/O state, update the current SCSI 
SCRIPTS with the memory address and byte 
count located in the 530700. Save a pointer 
to this SCSI SCRIPTS in the system I/O 
structure so that the I/O can easily be 
rescheduled. The chip's SCSI SCRIPTS 
pointer value is actually the current SCSI 
SCRIPTS address plus eight. So the saved 
value must be the SCSI SCRIPTS pointer 
value minus eight 


£AS£-1 

A message comes in on a Block Move 
command boundary. 

If no test for data phase was placed between 
Block Move commands, then the 53C700 
will fetch the next command and start 
processing it When the phase change actually 
occurs, the 53C700 may have data in it, so the 
processing is exactly the same as CASE 1 
above. 

If a wait and test for data phase command is 
inserted between each Block Move (burst size 
is known or the block size is used in each 
Block Move command), then an intermpt is 
generated to signal the processor to save a 
pointer to the next Block Move command. A 
SCSI SCRIPTS to receive message bytes is 
executed, ^d the I/O can be resumed by 
reloading tiie saved SCSI SCRIPTS pointer. 

Alternatively, the message processing SCSI 
SCRIPTS could have a jump command as its 
last command. The jump to address would be 
the entry point of the resume SCSI SCRIPTS 
pointer so that the intermpted I/O can start up 
again easily. 


Data Out Phase 

If the phase is data out, the 53C700 is full of 
data bytes going out to the SCSI bus. 
Execution stops after the phase change and an 
interrupt is generated to the external 
processor. At that time, the processor should 
calculate the number of bytes in the chip, add 
this value to the chip's bj^e count, subtract 
from the chip's memory address pointer, and 
store these values in the current SCSI 
SCRIPTS. A pointer to the SCSI SCRIPTS 
(minus eight) must be saved in some I/O 
stmcture for rescheduling. This saved value 
is the entry fwint for resuming the data 
transfer portion of the I/O, depending on the 
outcome of the phase change. 
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Chapter 10 

Multi-Tasking I/O Using SCSI SCRIPTS™ 


To accommodate multi-tasking I/O entirely 
within SCSI SCRIPTS, some special 
techniques are required. A standard SCSI 
SCRIPTS algorithm (the I/O descriptor) must 
be developed for each concurrent I/O. I/O’s 
can be linked together by making the last 
SCSI SCRIPTS command of each scheduled 
I/O descriptor a jump to the next scheduled I/O 
descriptor. This last command address is 
effectively a mailbox for communication 
between tiie host computer and the 53C700, 
The external processor can patch the last 
command to a jump command if the next I/O 
descriptor has been scheduled by the logical 
VO, or patch an interrupt command if it has 
not been scheduled. The 53C7(X) will fetch a 
complete SCSI SCRIPTS (all 8 bytes), 
blocking out the processor. The iAPX 
286/386 can write 4 bytes, blocking out the 
53C700. The patch must be to the four byte 
opcode to allow a test/set capability. Thus, 
the second four bytes must be the SCSI 
SCRIPTS jump address and the interrupt 
value. All of the SCSI SCRIPTS algorithms 
are arranged in memory in a linked hst. To 
schedule an VO, the host processor must: 

• Find the address of the first open VO 
descriptor (SCSI SCRIPTS program). 

• Update the variable addresses of user 
and SCSI data within the VO 
descriptor. 

• Change the last command of the VO 
descriptor (currently an interrupt 
command) to an interrupt with the VO 
descriptor I.D. as the last four bytes. 
At interrupt time, this information 
allows a fast identification of the 

VO just completed (when no other VO 
is scheduled). 

• Change the last command of the 
previous VO descriptor (currently 
functioning as an interrupt command) 
to a jump to the beginning of the 
newly scheduled VO descriptor. 


A series of VO's can be scheduled by the host 
processor. When an VO completes, if there is 
no other scheduled VO, then the 53C700 
interrupts the command register using the VO 
descriptor I.D.; otherwise it jumps to the next 
scheduled VO. The processor knows that an 
VO has completed when: 

• An interrupt occurs for a given VO 
because of an error. 

• The address of the SCSI SCRIPTS 
Command being executed is outside 
the address space of the VO descriptor 
being tested for completion. Wrap 
around must be considered in this test. 

The host processor can trigger this test 
through a timer interrupt or a polling 
scheme. 

• The SCSI status byte is written into a 
known address to flag that the I/O is 
complete. The host processor can use 
a timer interrupt or a polling scheme. 

• Some types of hardware assists 
generate an interrupt at the completion 
of the VO. The interrupt occurs when 
SCSI status byte being written into a 
main memory address interrupts the 
host processor. 


When an VO is completed, the last SCSI 
SCRIPTS command of the VO descriptor 
must be changed to an interrupt command to 
initialize it for the next VO to be scheduled (the 
I.D. value is set to an invalid value). The VO 
driver must take care that an infinite loop is 
NOT established with the SCSI SCRIPTS 
jump command. This simple software 
mechanism allows the 53C700 to schedule VO 
requests without a sophisticated host bus 
adapter. 
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Multi-Tasking I/O Using SCSI SCRIPTS™ 


Using SCSI SCRIPTS to implement Multi-Threaded I/O 


I/O #1 I/O #2 I/O #3 



I/O #4 I/O #5 I/O #6 



F/gi/re 4. Using SCSI SCRIPTS to Implement Multi-Threaded I/O 


In this example, all six I/O's have been scheduled by patching the last SCSI SCRIPT in each I/O 
descriptor to jump to the next scheduled I/O descriptor. When each I/O is complete, the linked 
list is broken by patching out the jump instraction to the next I/O descriptor. 
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Appendix A 

High Performance Considerations for 53C700 vs 53C90 


This chapter compares firmware required for 
the 53C700 and the 53C90 to determine how 
much of a performance boost the 53C7(X) can 
offer at a system level (I/O's per second). 
One microsecond is the time assumed for 
execution of each external processor 
instraction. 


Sample Input Data Structure 

The following data structure is typical at the 
SCSI H/W driver level when performing an 
I/O, 

I.D. message byte count 
Input message buffer address 
Output message buffer address 
SCSI command byte count 
SCSI command buffer address 
User data byte count 1 
User data buffer address 1 


User data byte count 'n' 

User data buffer address 'n' 

SCSI status buffer address 
Command Complete message address 


Initializing SCSI SCRIPTS^ for an 
I/O and Starting I/O Operations 

53C700 Algorithm Description 

Refer to the sample initiator SCSI, SCSI 
SCRIPTS for details about the exact sequence 
and values to be updated. At the firmware 
level, the Initiator SCSI, SCSI SCRIPTS 
must be updated with the address and count 
for the various SCSI data and user data 
required to perform an I/O. In the sample 
initiator algorithm, fifteen values must be 
updated! Basically, all the Block Move 
commands must be altered. The firmware 
sequence requires: 

Load Address Of Data/Count In Main Memory 
Load Value Desired From Main Memory 
Load SCSI SCRIPTSTM Offset 
Store Value In SCSI SCRIPTS™ Offset 


Approx 

t ime in . us 

Assuming that the sequence above 
takes about four microseconds. 

the total time is 60 

Executing the initiator algorithm 
takes about 30 SCSI SCRIPTS 
fetches and decodes. 

the total overhead is 15 

If disconnect fi:om the target after 
transferring the SCSI command, there 
will be two interrupts to the host 
processor. Each interrupt takes about 
80 micro seconds. 

the total time is 160 

60 + 15 + 160 = 235 psec overhead. 

Note that the SCSI portion of the interrupt 
service routine is only two or three lines of 
code because both interrupting situations are 
controlled by SCSI SCRffTS, requiring only 
a read of the interrupt code. 


53C90 Algorithm Description 

The firmware begins the sequence by 
preloading the 53C90 FIFO with the SCSI 
I.D. message followed by a ten byte SCSI 
command. The firmware sequence involved 
requires: 

Loop: Read Next Byte 
Write Next Byte 
Go To Loop If Count Not Zero 

For eleven bytes, the above sequence requires 
about 33 microseconds. Once the SCSI 
operation begins, the 53C90 requires the 
overhead listed below. (Note that each 
interrupt requires some reads and processing 
to determine the exact cause of the chip's 
interrupt.) Assume that an extra 20 
microseconds is required for each interrupt for 
a total of 100 (80 + 20) microseconds. 
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High Performance Considerations for 53C700 vs 53C90 


The following sequence is required to perform 
a SCSI operation. 

psec 


Send the SCSI command 033 

Interrupt -- msg in phase 100 

Interrupt - msg accepted 100 

Interrupt - physical disc 100 

Interrupt -- reselected 100 

Initialize DMA Logic 025 

I nterrupt - transfer complete 10 0 

Interrupt -- completion seq 100 

Interrupt - msg accepted 100 

interrupt - physical disc 100 


Total time 858 microseconds 


Conclusion 

The 53C700 requires about 25% of the normal 
firmware overhead associated with a 53C90, 
in the simplest case. To further compare the 
chips, note that a SAVE DATA POINTER 
operation in the 53C90 requires two processor 
interrupts (200 |isec) and only one interrupt 
using the 53C700 

(80 - 90 jxsec). Each data segment in a 
scatter/gather situation requires 125 jisec on 
the 53C90 (one interrupt plus DMA initialize) 
but only .5 fxsec on the 53C700 (500 
nanosecond instruction fetch). So, an I/O that 
required four data segments in a scatter/gather 
mode would require 500 psec on the 53C90 
and 2 psec on the 53C700 for user data 
transfer. These factors translate into a four 
segment data transfer as follows. 

53C90 

(858) + (3x125) = (858+375) 

1233 psec per I/O 


53C700 

237 psec per I/O 


To translate this improvement into I/O's per 
second, assume a 4K data transfer size, 
consisting of four IK segments in host 
memory, a target overhead of one millisecond 
(excluding seek times), and a 4 megabyte per 
second user data transfer rate on the SCSI 
bus. 


Function 

53090 
in msec 

53C700 
in msec 

Data Transfer Time 

1.00 

1.00 

Target overhead 

1.00 

1.00 

Host Overhead 

1.25 

0^ 

Total times 

3.25 

2.25 

I/O's Per Second 

307 

444 


In this projected environment, a system can 
increase its throughput rate by fifty percent by 
using the 53C700 and reducing host computer 
firmware overhead. With the types of 
buffered SCSI disk drives currently available, 
the 53C700 eliminates the host computer 
firmware as the high performance bottleneck. 

Remember that a 125 psec delay between user 
data segments may cause a disk drive to slip a 
revolution translating into a dramatic decrease 
in data throughput. 

Without the 53C700, to increase system level 
performance, designers must eliminate each 
delay. The 53C700 can remove much of the 
host overhead associated with each I/O. 
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Appendix B 

53C700 System Bus Utilization 


The 530700, in the laboratory environment 
transfers 512 bytes of user data at the rate of 

6,666 transfers per second (150 microseconds 
per I/O). The synchronous SCSI burst rate is 
set at 5 Mbytes per second. This I/O's per 
second rate is a limit for the 53C700, because 
no firmware intervention is required. 

A real concern is host bus utilization, or "Does 
the 53C700 affect host computer performance 
significantly?" This appendix provides 
information about host bus usage when the 
SCSI bus is saturated at a block size of 512 
bytes. 


Host Bus Time To Fetch A SCSI 
SCRIPTS Command 

80 nsec - Arbitrate and bus settle 
80 nsec - Fetch 4 bytes 
80 nsec - Fetch 4 bytes 
d[Q nsgg.jr Bus settle time 
280 nsec - Total time 

Completing an I/O requires 14 SCSI 
SCRIPTS. 

select with ATN 

jump error, when not MSG_OUT 
move, msg_buf, when MSG_OUT 
jump error, when not CMD phase 
move, cmd_buf, when CMD 
jump error, when not DATAJN 
move, clata_buf, when DATAJN 
jump error, when not STATUS 
move, status_buf, when STATUS 
jump error, when not MSGJN 
move, msg_buf, when MSGJN 
clear ack 
wait disconnect 
int 0x001 
error: 
int OxOff 


The time required to execute the SCSI 
SCRIPTS with no exception conditions is as 
follows. 

14X280 = 3.92 psec 

6,666 X 3.92 = 26.13 psec 
(total fetch time per second) 

The fetch time is 2.6% of the available 
system bus time (one second). 


Fetching data across the system bus requires: 


Time in 
nsec 

Instruction 


200 

I.D. msg fetch = 

80 (data fetch) 



+ 80 (arbitrate) 

+ 40 (settle) 

360 

command fetch = 

240 (three data fetches) 

+ 120 (arbitrate + settle) 

200 

Status byte fetch 


200 

COMMAND COMPLETE message 

960 

Total time per 

SCSI command 


Total SCSI related data fetch time is: 


6,666 X 960 = 6.4 msec 

which is 0.64% of the available system time 
(one second). 

Total overhead time is: 

0.64% + 2.6% = 3.24% of the time available 

The effective user data transfer rate is 3,333 
Mbytes per second, or about 6.66% of the 
available system bandwidth. Including time 
for bus arbitration, the available system 
bandwidth being absorbed by user data 
transfer is increased to about 8%. 
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53C700 System Bus Utilization 


Conclusion 

So the total time to saturate the SCSI bus takes 
11.2% of the iAPX 286/386 system bus 
available with a block size of 512 bytes per 
SCSI command. 

Using larger block sizes lowers SCSI 
command overhead (fewer commands per 
second) and increases the data transfer rates. 
For example, a IK block implies 250 p-sec per 
I/O (50 psec SCSI overhead as measured in a 
lab environment and 200 psec for user data). 
This is 4000 VO's per second or 4 Mbytes per 
second. The total 386 bus overhead is 
reduced to about 1.95% of the available time 
(4000/6666 X 3.24%). As the block size 
increases, the overhead decreases. 
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Appendix C 

SCSI SCRIPTS™ Compiler 


The SCSI SCRIPTS Compiler is a two pass 
compiler. 

The first pass compiler creates an output 
file in generic format from a SCRIPTS 
source file. This may be included in the 
user's source code for any language. 

The second pass compiler takes the passl 
file and creates a C file which may used 
in any C program. 

To provide portability this compiler does not 
support directory pa^s. The compiler and the 
files to be compiled must reside in the same 
directory. 


SCSI SCRIPTS Compiler Pass 1 
(ss.exe) 

A SCRIPTS source file may be created using 
any standard text editor that can create an 
ASCII file output. In the example below, the 
SCRIPT source file is SCRIPT.ss. To 
compile SCRIPT.ss use the following format: 

ss<input SCRIPT.ss> <output SCRIPT FILE> <options> 


Example : 

ss SCRIPT.ss SCRIPT.psI /s 
This creates two output files: 

SCRIPT.psI compiled output of the 

SCRIPT source file 

SCRIPT.xrf cross reference listing. 

If there are syntax errors in the SCRIPTS 
source file, the line number and error message 
are displayed on the screen. The error 
messages can be saved into a file by adding 
the /s option to your compile command. If 
there were errors in this example, the file name 
generated would be SCRIPT.ERR. Appendix 
D lists the compiler error messages. 


Output File Description 

The passl compiled output, SCRIPT.psI is in 
a generic format. The SCRIPT instruction list 
is always generated first. The first instruction 
column contains the long word instruction. 

The second column contains the 
corresponding long word address. 

Example: 

INSTRUCTIONS 

90008000 OOOOOOOA 

90008017 00000023 

The next hst contains a relative or absolute 
variable followed by its value. The next line 
contains the long word offsets in the SCRIPT 
where the variable is used. 

Example : 

R_data_buf 00000020 

OOOOOOOd 

The variable entry is followed by the SCRIPT 
entry label values. 

Example: 

Ent_alt_adr = 00000078 

The SCRIPT entry label values are followed 
by the list of long word offsets for labels in 
the SCRIPT. These offsets are used to patch 
in the absolute addresses at runtime. 

Example: 

LABELPATCHES 

00000001 

00000019 

0000001b 

The last item is a count of the number of 
instructions and patches in the SCRIPT. 

Example: 

INSTRUCTIONS 00000011 

PATCHES 00000003 
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SCSI SCRIPTS™ Compiler 


SCRIPT.xrf File Description 

(SCRIPT cross-reference file) 

For every instruction, the cross reference file 
(.xrf) lists 

an offset firom the beginning of the script, 
the long word instruction, 
the long word address, and 
the corresponding source SCRIPT 
instruction. 

Labels appear on a line by themselves as they 
are encountered in the SCRIPT. After the 
cross reference is a list consisting of the 
absolute or relative variable, the variable name 
and location in the SCRIPT. 

This is followed by a list of labels and label 
locations that appear in the SCRIPT. The 
location is an offset from the beginning of the 
SCRIPT. 

The last information list gives the label 
patches. Label patches are offsets into the 
SCRIPT where a label is referenced. They are 
called patches because the absolute address of 
the labels must be patched into the SCRIPT at 
program runtime. Use the Patch Utilities 
described in Section 4 of the NCR 530700 
Programmer's Guide. 


SCSI SCRIPTS Compiler Pass2 
(pass2.exe) 

Pass2 creates a C format file from the passl 
compiler output. If the passl output file is 
SCRIPT.ps 1, then the format for using Pass2 
will be as follows. 

pass2 <pass1 fiie> <Cfile> 

pass2 SCRIPT.psI SCRIPT.ps2 

When you run the compile, the following 
message will be displayed on your screen. 


SCSI Scripts (TM) Compiler Pass2, 
VO.OlBeta 

Copyright (C) 19989 NCR 
Requires 0x3e7 bytes of memory. 


The memory requirement is the number of 
bytes in the SCMPT.ps 1 file. Without this 
amount of memory, the compiler will not 
execute properly. 

Pass2 reads in clusters of characters called 
tokens until a separator is encountered, such 
as space, tab, line feed, or end of file. Tokens 
can be identifiers, variables, or numbers. 
When an identifier is encountered, an array of 
unsigned long elements is generated in the C 
output file. First, a value is defined for a 
variable, then an array of unsigned long 
elements is generated. These elements indicate 
where in the SCRIPT the variable is used. 
Numeric values are given an "Ox" prefix for 
hexadecimal numbers in C format. 

The SCRIPT instractions array is always 
generated first The first column contains the 
long word instruction and the second the 
corresponding long word address. 
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SCSI SCRIPTS™ Compiler 


Emmk: 

ULONGSCRIPT[] = { 

0x90008000. OxOOOOOOOA, 
0x90008017, 0x00000023 

}; 

The variable name prefix will have an" A_" for 
absolute or an "R_ "for relative. This is 
followed by the variable value. The define 
statement is followed by an array which 
contains the long word offsets into the 
SCRn*T where the variable is used. The array 
name is the variable name appended with 
"_Used". 

Em m l ei 

#deflneR_DATA_BUF 0X00000020 
ULONG R_data_buf_Used[ ] = { 

}: 


Next define the SCRIPT entry label values that 
are prefixed with an "Ent_". 

Example: 

#define Ent_alt_adr 0x00000078 

The SCRIPT entry labels values are followed 
by an array of long word offsets for labels in 
the SCRU^. These offsets patch in the 
absolute addresses at runtime. 

Example: 

ULONG LABELPATCHESn = { 

0x00000001, 0x00000019, 
0x0000001b 

}; 


Next is the last item, the number of 
instmctions and patches in the SCRIPT. 

Example: 

ULONG INSTRUCTIONS = 0x00000011; 
ULONG PATCHES = 0x00000003; 

Since an error file was generated with the 
Passl compile, Pass2 does little error 
checking. Do not give Pass2 a file in a 
different format (i.e. other than Passl). 
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Compiler^i 


endix D 
cript Examples 


SCSI SCRIPTS Compiler Pass1 SCRIPT Scource File (sample.ss) 

RELATIVE msg_buf=0, cmd_buf=nisg_buf+l, stat_buf=cmd_buf+10 
RELATIVE msg_in_buf=stat_buf+l, data_buf = msg_buf+32 

ENTRY alt_adr, alt2, s_write 


;INrnATOR WRITE SCRIPT 
s_write: 

select ATN 01, alt_adr 

int 6, when not MSG_OUT 
move 1, msg_buf, when MSG_OUT 

int 7, when not CMD 
move 6, cmd_buf, when CMD 

int 75, when not DATA_OUT 
move 512, data_buf, when DATA_OUT 

int 8, when not STATUS 
move i, stat_buf, when STATUS 

int 9, when not MSG_IN 

move 1, msg_in_buf, when MSG_IN 

int 95, if not 00 

clear ACK alt2 

wait disconnect alt2 

int 10 

; end Initiator Write SCRIPT 


select the target 

check for message out phase next 
move the message byte in 

check for command phase next 
move the command bytes out next 

interrupt if not data out phase 
move data bytes 

check for status phase next 
move the status byte in 

check for message in phase 
move the command complete message in 
interrupt if not a command complete message 
accept the message byte 

wait for the bus free interrupt 

interrupt when the command is completed 


alt_adr: 

int 11 interrupt if jump to alt_adr during selection 

alt2: 

int 12 -.interrupt if jump to alt2 
;end of SCRIPT 
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Compiler Script Examples 


SCSI SCRIPTS Compiler Pass 1 
Passl Compiler Output (smple.psl) 

INSTRUCTIONS 


41010000 

00000078 

9E030000 

00000006 

06000001 

00000000 

9A030000 

00000007 

02000006 

00000001 

98030000 

0000004B 

00000200 

00000020 

9B030000 

00000008 

03000001 

OOOOOOOB 

9F030000 

00000009 

07000001 

OOOOOOOC 

98040000 

0000005F 

60000040 

00000080 

48000000 

00000080 

98080000 

OOOOOOOA 

98080000 

OOOOOOOB 

98080000 

OOOOOOOC 


R_msg_biif 00000000 

00000005 

R_cmd_buf 00000001 

00000009 

R_stat_buf OOOOOOOB 

00000011 

R_insg_in_buf OOOOOOOC 

00000015 

R_data_buf 00000020 

OOOOOOOd 

Ent_alt_adr 00000078 

Ent_alt2 00000080 

Ent_s_write 00000000 

LABEL PATCHES 
00000001 
00000019 
0000001b 

COUNTS 

INSTRUCTIONS 00000011 

PATCHES 00000003 
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Compiler Script Examples 


SCSI SCRIPTS Compiler Pass2 
Pass2 Compiler Output (sample.ps2) 
typedef unsigned long ULONG; 


ULONG SCRIPTn = { 

0x41010000, 0x00000078, 

0x9E030000, 0x00000006, 


}; 


0x06000001, 

0x9A030000, 

0x02000006, 

0x98030000, 

0x00000200, 

0x9B030000, 

0x03000001, 

0x9F030000, 

0x07000001, 

0x98040000, 

0x60000040, 

0x48000000, 

0x98080000, 

0x98080000, 

0x98080000, 


0x00000000, 

0x00000007, 

0x00000001, 

0x0000004B, 

0x00000020, 

0x00000008, 

OxOOOOOOOB, 

0x00000009, 

OxOOOOOOOC, 

OxOOOOOOSF, 

0x00000080, 

0x00000080, 

OxOOOOOOOA, 

OxOOOOOOOB, 

OxOOOOOOOC 


#define R_msg_buf 0x00000000 
ULONG R_nisg_buf_UsedD = { 

0x00000005 

}; 


#de£ine R_cmd_buf 0x00000001 

ULONG R_cmd_buf_Usedn = { 

0x00000009 

}; 

#define R_stat_buf OxOOOOOOOB 

ULONG R_stat_buf_UsedD = { 

0x00000011 

}; 


#define R_msg_in_buf OxOOOOOOOC 
ULONG R_msg_in_buf_UsedD = { 

0x00000015 

}; 


#defiDne R_data_buf 0x00000020 

ULONG R_daia_buf_UsedD = { 

OxOOOOOOOd 

}; 

#define Ent_alt_adr 0x00000078 

. #define Ent_alt2 0x00000080 

#define Ent_s_write 0x00000000 

ULONG LABELPATCHESn = { 

0x00000001, 0x00000019, 

OxOOOOOOlb 

); 

ULONG INSTRUCTIONS = 0x00000011; 

ULONG PATCHES = 0x00000003; 
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Compiler Script Examples 


SCSI SCRIPTS Cross Reference File Listing (sample.xrf) 


SCRIPT FILE: sample.ps 1 


s_write: 

0000 41010000 00000078 
0008 9E030000 00000006 
0010 06000001 00000000 
0018 9A030000 00000007 
0020 02000006 00000001 
0028 98030000 0000004B 
0030 00000200 00000020 
0038 9B030000 00000008 
0040 03000001 OOOOOOOB 
0048 9F030000 00000009 
0050 07000001 OOOOOOOC 
0058 98040000 0000005F 
0060 60000040 00000080 
0068 48000000 00000080 
0070 98080000 OOOOOOOA 
alt_adr: 

0078 98080000 OOOOOOOB 
alt2: 

0080 98080000 OOOOOOOC 


select ATN 01, alt_adr 

int 6, when not MSG_OUT 

move 1, msg_buf, when MSG_OUT 

int 7, when not CMD 

move 6, cmd_buf, when CMD 

int 75, when not DATA_OUT 

move 512, data_buf, when DATA_OUT 

int 8, when not STATUS 

move 1, stat_buf, when STATUS 

int 9, when not MSG_IN 

move 1, msg_in_buf, when MSG_E^ 

int 95, if not 00 

clear ACK alt2 

wait disconnect alt2 

int 10 


; select the target 

; check for message out phase next 
; move the message byte in 
; check for command phase next 
; move the command bytes out next 
; interrupt if not data out phase 
; move data bytes 
; check for status phase next 
; move the status byte in 
; check for message in phase 
; move the command complete message in 
; interrupt if not a command complete message 
; accept the message byte 
; wait for the bus free interrupt 
; interrupt when the command is completed 


int 11 


;interrupt if jump to alt_adr during selection 


int 12 


interrupt if jump to alt2 


RELATIVE msg_buf = 00000000 
00000010 

RELATIVE cmd_buf = 00000001 
00000020 

RELATIVE stat_buf = 0000000b 
00000040 


RELATIVE msg_in_buf = 0000000c 
00000050 

RELATIVE data_buf=00000020 
00000030 

ENTRY LABEL: alt_adr at address 00000078 

ENTRY LABEL: alt2 at address 00000080 

ENTRY LABEL: s_write at address 00000000 

LABEL PATCH at 00000001 

LABEL PATCH at 00000019 

LABEL PATCH at 0000001b 
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Appendix E 

SCRIPTS™ Compiler Error Messages 


Fatal Error: . . . 

Fatal Error: No memory. Aborting compiler 

There is not enough available memory to read the SCRIPT into RAM. 

Fatal Error: Local stack overflow. Aborting compile...: 

Please contact NCR immediately, you have an obsolete version of SCRIPTS. 

Fatal Error: Cannot open file: 

The SCRIPT file cannot be opened or one of the output files (.ERR or .XRF) are 
corrupt. Compilation is terminated. 

Fatal Error: Cannot read file: 

The file was opened, but could not be read. Compilation is terminated. 
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SCRIPTS™ Compiler Error Messages 


Error: ... 

Error: Expected digit: 

While evaluating a number, a character other than a legal digit was encountered. 

Error: Expected a separator: 

A separator was expected, insert a comma, EOL character or any other legal 
separator. 

Error: Numeric constant has too many digits: 

A number, either decimal, hex or binary contains too many digits. 

Error: Expected a value: 

A value was expected, but instead an operator, pseudo-op, or instruction was 
encountered. 

Error; Undefined variable: 

A variable was encountered that was not defined at the beginning of the SCRIPT. 

Error: Unknown Identifier; 

An identifier was encountered that was not a "+",or any other expected 
separator. 

Error: Expected an identifier: 

A reserved word was encountered where there should have been an identifier. 

Error: Expected a variable: 

A pseudo op, instruction, or reserved word was encountered where a variable was 
expected. 

Error: Expected an expression: 

A mathematical expression was expected but not found. If you encounter this error 
message, contact NCR, you have an old version of SCRIPTS. 

Error: Expected a reserved word: 

A reserved word was expected (WITH, WHEN, IF, etc.) but was not encountered. 
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SCRIPTS™ Compiler Error Messages 


Error: Expected a PHASE: 

An instruction was used in which a phase was expected and but was not found in the 
instructions. 

Error: Cannot use a RELATIVE in a non address field: 

A relative variable was used in a field that was not an address field. 
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SCRIPTS™ Compiler Error Messages 


Warning: ... 

Warning: Identifier truncated: 

An identifier, such as a label contained more than 32 characters and was truncated. 

Warning: Redefinition of variable: 

A variable was defined two or more times. 

Warning: Duplicate ATN: 

ATN has already been set and you are attempting to set it again. 

Warning: Duplicate ACK: 

ACK has already been set and you are attempting to set it again. 

Warning: Undefined label used as entry point: 

The label was not defined as an entry point. 

Warning: Unused variable: 

A variable was defined but not used in the SCRIPT. 

Warning: Lost resolution: 

A number encountered was too large. For example, using 8 as a SCSI ID. SCSI ID 
numbers can be no larger than 7. 

Warning: Duplicate label: 

A label was defined more than once. 

UNKNOWN ERROR! 

You have just experienced a phenomenona known as cosmic ray bombardment. This is 
believed to be associated with increased solar flare activity. Fortunately, the 
effects are not permanent, try again. 
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NCR Microelectronic Products Division - Sales Locations 


For literatnre on any NCR 
Microelectronics product or service 
call the NCR hotline toll-free: 

l>800-334-5454 
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Santa Gara, CA 95054 
(408)980*6200 
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1-800-525-2252 
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